diff --git a/README.md b/README.md
index 2991b0f..5622a05 100644
--- a/README.md
+++ b/README.md
@@ -28,6 +28,10 @@ For manual deployment, run
 bundle exec nanoc deploy --target public
 ```
 
+## Posts
+
+Posts should be written in [kramdown](http://kramdown.gettalong.org/index.html), a markdown superset which has a very complete [syntax guide](http://kramdown.gettalong.org/syntax.html).
+
 ## Events
 
 Example structure: