git.iko.soy/typeable/pandoc
on master help sign in
Merge pull request #2138 from lierdakil/backtick-code-blocks

README: Add documentation on backtick_code_blocks

commit41a457a649cb981c703375181964314523546d72 authorJohn MacFarlane <jgm@berkeley.edu> dateThu 7 May 2015, 09:10 (11 years ago) parent472c142c5724ea
1 file changed+11−6
README+11−6
README+11−6
@@ -1337,9 +1337,9 @@ Note: blank lines in the verbatim text need not begin with four spaces.
13371337
13381338In addition to standard indented code blocks, Pandoc supports
13391339*fenced* code blocks. These begin with a row of three or more
1340−tildes (`~`) or backticks (`` ` ``) and end with a row of tildes or
1341−backticks that must be at least as long as the starting row. Everything
1342−between these lines is treated as code. No indentation is necessary:
1340+tildes (`~`) and end with a row of tildes that must be at least as long as
1341+the starting row. Everything between these lines is treated as code. No
1342+indentation is necessary:
13431343
13441344 ~~~~~~~
13451345 if (a > 3) {
@@ -1359,9 +1359,14 @@ row of tildes or backticks at the start and end:
13591359 ~~~~~~~~~~
13601360 ~~~~~~~~~~~~~~~~
13611361
1362+#### Extension: `backtick_code_blocks` ####
1363+
1364+Same as `fenced_code_blocks`, but uses backticks (`` ` ``) instead of tildes
1365+(`~`).
1366+
13621367#### Extension: `fenced_code_attributes` ####
13631368
1364−Optionally, you may attach attributes to the code block using
1369+Optionally, you may attach attributes to fenced or backtick code block using
13651370this syntax:
13661371
13671372 ~~~~ {#mycode .haskell .numberLines startFrom="100"}
@@ -2690,8 +2695,8 @@ can produce `.json` and `.yaml` files from any of the supported formats.
26902695
26912696In-field markup: In bibtex and biblatex databases, pandoc-citeproc parses
26922697(a subset of) LaTeX markup; in CSL JSON databases, an HTML-like markup
2693−([specs](http://docs.citationstyles.org/en/1.0/release-notes.html#rich-text-markup-within-fields));
2694−and in CSL YAML databases, pandoc markdown. `pandoc-citeproc -j` and `-y`
2698+([specs](http://docs.citationstyles.org/en/1.0/release-notes.html#rich-text-markup-within-fields));
2699+and in CSL YAML databases, pandoc markdown. `pandoc-citeproc -j` and `-y`
26952700interconvert these markup formats as far as possible.
26962701
26972702As an alternative to specifying a bibliography file, you can include