From a7c9a69004541cc598e711584fbf88ed6ecc62af Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Sun, 9 Aug 2020 10:45:38 -0700 Subject: [PATCH] MANUAL: remove lists of support extensions for markdown variants. Instead, offer the advice to use `--list-extensions=FORMAT`. Closes #6604. --- MANUAL.txt | 58 +++++++++++++++--------------------------------------- 1 file changed, 16 insertions(+), 42 deletions(-) diff --git a/MANUAL.txt b/MANUAL.txt index aeef074dc..ae55669fc 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -5135,52 +5135,26 @@ for regular emphasis, add extra blank space around headings. In addition to pandoc's extended Markdown, the following Markdown variants are supported: -`markdown_phpextra` (PHP Markdown Extra) -: `footnotes`, `pipe_tables`, `raw_html`, `markdown_attribute`, - `fenced_code_blocks`, `definition_lists`, `intraword_underscores`, - `header_attributes`, `link_attributes`, `abbreviations`, - `shortcut_reference_links`, `spaced_reference_links`. +- `markdown_phpextra` (PHP Markdown Extra) +- `markdown_github` (deprecated GitHub-Flavored Markdown) +- `markdown_mmd` (MultiMarkdown) +- `markdown_strict` (Markdown.pl) +- `commonmark` (CommonMark) +- `gfm` (Github-Flavored Markdown) +- `commonmark_x` (CommonMark with many pandoc extensions) -`markdown_github` (deprecated GitHub-Flavored Markdown) -: `pipe_tables`, `raw_html`, `fenced_code_blocks`, `auto_identifiers`, - `gfm_auto_identifiers`, `backtick_code_blocks`, - `autolink_bare_uris`, `space_in_atx_header`, - `intraword_underscores`, `strikeout`, `task_lists`, `emoji`, - `shortcut_reference_links`, `angle_brackets_escapable`, - `lists_without_preceding_blankline`. +To see which extensions are supported for a given format, +and which are enabled by default, you can use the command -`markdown_mmd` (MultiMarkdown) -: `pipe_tables`, `raw_html`, `markdown_attribute`, `mmd_link_attributes`, - `tex_math_double_backslash`, `intraword_underscores`, - `mmd_title_block`, `footnotes`, `definition_lists`, - `all_symbols_escapable`, `implicit_header_references`, - `auto_identifiers`, `mmd_header_identifiers`, - `shortcut_reference_links`, `implicit_figures`, - `superscript`, `subscript`, `backtick_code_blocks`, - `spaced_reference_links`, `raw_attribute`. + pandoc --list-extensions=FORMAT -`markdown_strict` (Markdown.pl) -: `raw_html`, `shortcut_reference_links`, - `spaced_reference_links`. - -We also support `commonmark` and `gfm` (GitHub-Flavored Markdown, -which is implemented as a set of extensions on `commonmark`). - -Note, however, that `commonmark` and `gfm` have limited support -for extensions. Only those listed below (and `smart`, -`raw_tex`, and `hard_line_breaks`) will work. The extensions -can, however, all be individually disabled. Also, `raw_tex` -only affects `gfm` output, not input. - -`gfm` (GitHub-Flavored Markdown) -: `pipe_tables`, `raw_html`, `native_divs`, - `fenced_code_blocks`, `auto_identifiers`, - `gfm_auto_identifiers`, `backtick_code_blocks`, - `autolink_bare_uris`, `space_in_atx_header`, - `intraword_underscores`, `strikeout`, `task_lists`, `emoji`, - `shortcut_reference_links`, `angle_brackets_escapable`, - `lists_without_preceding_blankline`. +where `FORMAT` is replaced with the name of the format. +Note that the list of extensions for `commonmark`, +`gfm`, and `commonmark_x` are defined relative to default +commonmark. So, for example, `backtick_code_blocks` +does not appear as an extension, since it is enabled by +default and cannot be disabled. # Producing slide shows with pandoc