From 7ac6d3796b19beccf575ea6e3e6c66673561d9e6 Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Mon, 1 Sep 2014 07:56:07 -0700 Subject: Updated site for latest spec, narrative, js --- narrative.md | 22 ++++++++++++++++------ 1 file changed, 16 insertions(+), 6 deletions(-) (limited to 'narrative.md') diff --git a/narrative.md b/narrative.md index 5c4a616..4330bdd 100644 --- a/narrative.md +++ b/narrative.md @@ -47,11 +47,14 @@ description. There are only a few places where this spec says things that contradict the canonical syntax description: -- It allows all puncutation symbols to be backslash-escaped, not just - the symbols with special meanings in markdown. I found that it was - just too hard to remember which symbols could be escaped. - -- It introduces an alternative syntax for hard line breaks, a +- It [allows all puncutation symbols to be + backslash-escaped](http://jgm.github.io/stmd/spec.html#backslash-escapes), + not just the symbols with special meanings in markdown. I found + that it was just too hard to remember which symbols could be + escaped. + +- It introduces an [alternative syntax for hard line + breaks](http://jgm.github.io/stmd/spec.html#hard-line-breaks)), a backslash at the end of the line, supplementing the two-spaces-at-the-end-of-line rule. This is motivated by persistent complaints about the “invisible” nature of the two-space rule. @@ -93,7 +96,7 @@ the canonical syntax description: implementation flubs up.) - The spec stipulates that two blank lines break out of all list - contexts. This is an attempt to deal with issues that often come up + contexts. This is an attempt to deal with issues that often come up when someone wants to have two adjacent lists, or a list followed by an indented code block. @@ -101,8 +104,15 @@ the canonical syntax description: vice versa, starts a new list. I think that is almost always going to be the writer's intent. +- The number that begins an ordered list item may be followed by + either `.` or `)`. Changing the delimiter style starts a new + list. + - The start number of an ordered list is significant. +- [Fenced code blocks](http://jgm.github.io/stmd/spec.html#fenced-code-blocks) are supported, delimited by either + backticks (` ``` `) or tildes (` ~~~ `). + In all of this, I have been guided by eight years experience writing markdown implementations in several languages, including the first markdown parser not based on regular expression substitutions -- cgit v1.2.3