From a098f6ac517b8fbe64b286c46f831cd1794acaf1 Mon Sep 17 00:00:00 2001
From: John MacFarlane <jgm@berkeley.edu>
Date: Tue, 22 Jul 2014 10:41:28 -0700
Subject: Added more motivating examples.

---
 spec.txt | 65 ++++++++++++++++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 55 insertions(+), 10 deletions(-)

(limited to 'spec.txt')

diff --git a/spec.txt b/spec.txt
index 96721e6..b688ef7 100644
--- a/spec.txt
+++ b/spec.txt
@@ -44,7 +44,16 @@ questions it does not answer:
     (John Gruber has also spoken [in favor of requiring the blank
     lines](http://article.gmane.org/gmane.text.markdown.general/2146).)
 
-3.  What is the exact rule for determining when list items get
+3.  Is a blank line needed before an indented code block?
+    (`Markdown.pl` requires it, but this is not mentioned in the
+    documentation, and some implementations do not require it.)
+
+    ``` markdown
+    paragraph
+        code?
+    ```
+
+4.  What is the exact rule for determining when list items get
     wrapped in `<p>` tags?  Can a list be partially "loose" and partially
     "tight"?  What should we do with a list like this?
 
@@ -59,7 +68,6 @@ questions it does not answer:
 
     ``` markdown
     1.  one
-
         - a
 
         - b
@@ -69,8 +77,26 @@ questions it does not answer:
     (There are some relevant comments by John Gruber
     [here](http://article.gmane.org/gmane.text.markdown.general/2554).)
 
-4.  When list markers change from bullets to numbers, should we have
-    two lists or one?
+5.  Can list markers be indented?  Can ordered list markers be right-aligned?
+
+    ``` markdown
+     8. item 1
+     9. item 2
+    10. item 2a
+    ```
+
+6.  Is this one list with a horizontal rule in its second item,
+    or two lists separated by a horizontal rule?
+
+    ``` markdown
+    * a
+    * * * * *
+    * b
+    ```
+
+7.  When list markers change from numbers to bullets, do we have
+    two lists or one?  (The markdown syntax description suggests two,
+    but the perl scripts and many other implementations produce one.)
 
     ``` markdown
     1. fee
@@ -79,28 +105,37 @@ questions it does not answer:
     -  fum
     ```
 
-5.  What are the precedence rules for the markers of inline structure?
+8.  What are the precedence rules for the markers of inline structure?
     For example, is the following a valid link, or does the code span
     take precedence ?
 
     ``` markdown
-    [foo `](bar)`
+    [a backtick (`)](/url) and [another backtick (`)](/url).
     ```
 
-6.  What are the precedence rules for markers of emphasis and strong
+9.  What are the precedence rules for markers of emphasis and strong
     emphasis?  For example, how should the following be parsed?
 
     ``` markdown
-    *foo *bar** baz*
+    *foo *bar* baz*
+    ```
+
+10. What are the precedence rules between block-level and inline-level
+    structure?  For example, how should the following be parsed?
+
+    ``` markdown
+    - `a long code span can contain a hyphen like this
+      - and it can screw things up`
     ```
 
-7.  Can list items include headers?
+11. Can list items include headers?  (`Markdown.pl` does not allow this,
+    but headers can occur in blockquotes.)
 
     ``` markdown
     - # Heading
     ```
 
-8.  Can link references be defined inside block quotes or list items?
+12. Can link references be defined inside block quotes or list items?
 
     ``` markdown
     > Blockquote [foo].
@@ -108,6 +143,16 @@ questions it does not answer:
     > [foo]: /url
     ```
 
+13. If there are multiple definitions for the same reference, which takes
+    precedence?
+
+    ``` markdown
+    [foo]: /url1
+    [foo]: /url2
+
+    [foo][]
+    ```
+
 In the absence of a spec, early implementers consulted `Markdown.pl`
 to resolve these ambiguities.  But `Markdown.pl` was quite buggy, and
 gave manifestly bad results in many cases, so it was not a
-- 
cgit v1.2.3