aboutsummaryrefslogtreecommitdiff
path: root/MANUAL.txt
diff options
context:
space:
mode:
authorJohn MacFarlane <jgm@berkeley.edu>2020-08-09 10:45:38 -0700
committerJohn MacFarlane <jgm@berkeley.edu>2020-08-09 11:12:59 -0700
commita7c9a69004541cc598e711584fbf88ed6ecc62af (patch)
tree7bd07be735edfafb68103e0494423d1bdde7e3a2 /MANUAL.txt
parent499fc11fca83cf4991cb9bce223fa3d046d4fa68 (diff)
downloadpandoc-a7c9a69004541cc598e711584fbf88ed6ecc62af.tar.gz
MANUAL: remove lists of support extensions for markdown variants.
Instead, offer the advice to use `--list-extensions=FORMAT`. Closes #6604.
Diffstat (limited to 'MANUAL.txt')
-rw-r--r--MANUAL.txt66
1 files changed, 20 insertions, 46 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_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`.
-
-`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`.
-
-`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`.
-
+- `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)
+
+To see which extensions are supported for a given format,
+and which are enabled by default, you can use the command
+
+ pandoc --list-extensions=FORMAT
+
+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