diff --git a/Documentation/markdown.md b/Documentation/markdown.md
index bed3fe7..e1c6da3 100644
--- a/Documentation/markdown.md
+++ b/Documentation/markdown.md
@@ -768,6 +768,17 @@
   imageLimit = 256K
 ```
 
+### Parsing timeout
+
+Parsing Markdown can be expensive so this implementation places
+a default upper bound of 2 seconds on running time per document.
+This is measured in wall clock time from the start of the request.
+
+```
+[markdown]
+  parseTimeout = 2s
+```
+
 ### Google Analytics
 
 [Google Analytics](https://www.google.com/analytics/) can be