Document markdown limitations

srid · Apr 9, 2020 · 409a5a0 · 409a5a0
1 parent 6ef5392
commit 409a5a0
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 0 deletions.
diff --git a/guide/2011404.md b/guide/2011404.md
@@ -8,3 +8,4 @@ Zettel files are written using the [Markdown](https://en.wikipedia.org/wiki/Mark
 * [2011505](z://metadata)
 * [2013702](z://synhigh) 
 * [2013701](z://mathjax) 
+* [2014401](z://limit)
diff --git a/guide/2014401.md b/guide/2014401.md
@@ -0,0 +1,10 @@
+---
+title: Markdown Limitations
+---
+
+Zettel Markdown format is limited in a few ways owing to the strict parsing nature of `mmark`, the parser library used by neuron. 
+
+Notably, URI references must respect RFC 3986. Quotting [mmark's README](https://github.com/mmark-md/mmark#mmark-and-common-mark):
+
+> All URI references (in links, images, autolinks, etc.) are parsed as per RFC 3986, no support for escaping or support for entity and numeric character references is provided. In addition to that, when a URI reference in not enclosed with `<` and `>`, then closing parenthesis character `)` is not considered part of URI (use `<uri>` syntax if you want a closing parenthesis as part of a URI).
+