@@ -452,8 +452,8 @@ with `~~`. Thus, for example,
452452
453453 This ~~is deleted text.~~
454454
455−Lists
456−-----
455+Nested Lists
456+------------
457457
458458Pandoc behaves differently from standard markdown on some "edge
459459cases" involving lists. Consider this source:
@@ -477,6 +477,9 @@ Pandoc works this way even when the `--strict` option is specified. This
477477behavior is consistent with the official markdown syntax description,
478478even though it is different from that of `Markdown.pl`.)
479479
480+Ordered Lists
481+-------------
482+
480483Unlike standard markdown, Pandoc allows ordered list items to be marked
481484with uppercase and lowercase letters and roman numerals, in addition to
482485arabic numerals. (This behavior can be turned off using the `--strict`
@@ -705,6 +708,52 @@ These work like simple tables, but with the following differences:
705708 - They must end with a row of dashes, then a blank line.
706709 - The rows must be separated by blank lines.
707710
711+Delimited Code blocks
712+---------------------
713+
714+In addition to standard indented code blocks, Pandoc supports
715+*delimited* code blocks. These begin with a row of three or more
716+tildes (`~`) and end with a row of tildes that must be at least
717+as long as the starting row. Everything between the tilde-lines
718+is treated as code. No indentation is necessary:
719+
720+ ~~~~~~~
721+ {code here}
722+ ~~~~~~~
723+
724+If the code itself contains a row of tildes, just use a longer
725+row of tildes at the start and end:
726+
727+ ~~~~~~~~~~~~~~~~
728+ ~~~~~~~~~~
729+ code including tildes
730+ ~~~~~~~~~~
731+ ~~~~~~~~~~~~~~~~
732+
733+Optionally, you may specify the language of the code block using
734+this syntax:
735+
736+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ {.haskell}
737+ qsort [] = []
738+ qsort (x:xs) = qsort (filter (< x) xs) ++ [x] ++
739+ qsort (filter (>= x) xs)
740+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
741+
742+Some output formats can use this information to do syntax highlighting.
743+Currently, the only output format that uses this information is HTML.
744+The code block above would appear in the context
745+
746+ <pre class="haskell">
747+ <code>
748+ ...
749+ </code>
750+ </pre>
751+
752+This allows the HTML to be postprocessed using a syntax highlighting tool.
753+(Pandoc itself does not do any syntax highlighting.) Note that multiple
754+classes can be specified: for example, one might use `{.haskell
755+.number}` to specify that lines be numbered in the highlighted output.
756+
708757Title blocks
709758------------
710759