diff --git a/README.md b/README.md
index 1b36e7b7f950f57691f4b6146ae7782ad8d659ce..49dcc919eb666637a8e2eef6f2f6efe18bd16255 100644
--- a/README.md
+++ b/README.md
@@ -75,6 +75,17 @@ $$\begin{array}{c}
 \end{array}$$
 ```
 
+## Syntax
+
+Math parsing in markdown is designed to agree with the conventions set by pandoc:
+
+    Anything between two $ characters will be treated as TeX math. The opening $ must
+    have a non-space character immediately to its right, while the closing $ must
+    have a non-space character immediately to its left, and must not be followed
+    immediately by a digit. Thus, $20,000 and $30,000 won’t parse as math. If for some
+    reason you need to enclose text in literal $ characters, backslash-escape them and
+    they won’t be treated as math delimiters.
+
 ## Math Syntax Support
 
 KaTeX is based on TeX and LaTeX. Support for both is growing. Here's a list of