diff --git a/README.md b/README.md
index cf96191..cdb1e8f 100644
--- a/README.md
+++ b/README.md
@@ -48,6 +48,40 @@ support for
 
 Note: Tooltip-Syntax has changed.
 
+### Cols
+
+This filter makes multi-column-layouts out of lvl-x-headings
+
+Syntax is
+
+```
+## a b
+```
+
+yielding a 2-column-layout with aspects a:b i.e. 1:1 for 50/50-layout
+or 8:2 for 80/20 layout
+
+currently works for 2 and 3-columns, but extension is straight-forward.
+
+If you need multiple Block-Elements inside one column, just wrap them
+with a `<div>` or wait for [#168](https://github.com/jgm/pandoc/issues/168):
+
+```
+## 2 5
+
+<div>
+multiple things
+
+- foo
+- bar
+
+![image](...)
+</div>
+
+second column here with only 1 element.
+```
+
+
 ### Clean
 
 Small filter for cleaning empty Blocks if they get generated by accident.