This repository has been archived by the owner on Jan 3, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 85
markdown it vs. pandoc
Mauro Bieg edited this page Oct 20, 2018
·
5 revisions
- Configuration similarly to pandoc's configuration
- Support three main markdown flavors:
commonmark
markdown_github
markdown_pandoc
- Smart punctuation should be configurable.
- Support the following extensions:
Topic | Pandoc Feature | importance | markdown-it support |
---|---|---|---|
Headers | blank_before_header | low | yes |
Headers | header_attributes | low | plugin? |
Headers | auto_identifiers | low | plugin? |
Headers | implicit_header_references | low | ??? |
Images | implicit_figures | plugin | |
Blockquote | blank_before_blockquote | low | no support |
Code | fenced_code_blocks | high | built in |
Code | backtick_code_blocks | high | built in |
Code | fenced_code_attributes | medium | built in^1, plugin? |
Code | inline_code_attributes | medium | no support |
Line blocks | line_blocks | medium | ??? |
Lists | fancy_lists | medium | ??? |
Lists | startnum | medium | built in |
Lists | definition_lists | medium | plugin |
Lists | example_lists | medium | ??? |
Tables | table_cpations | medium | ??? |
Tables | simple_tables | medium | ??? |
Tables | multiline_tables | medium | ??? |
Tables | grid_tables | medium | ??? |
Tables | pipe_tables | high | built in |
Metadata | pandoc_title_block | low | ??? |
Metadata | yaml_metadata_block | low | Plugins: js-yaml-front-matter |
Escapes | all_symbols_escapable | medium | built in |
Emphasis | intraword_underscores | high | built in |
Emphasis | strikeout | high | built in |
Emphasis | superscript, subscript | high | Plugins: npm_sup, npm_sub |
Math | tex_math_dollars | high | plugin |
Math | latex_macros | medium | ??? |
Raw HTML | raw_html | high | built in |
Raw HTML | markdown_in_html_blocks | high | built in^2 |
Links | shortcut_reference_links | medium | built in |
Footnotes | footnotes | high | plugin |
Footnotes | inline_notes | high | plugin |
Citations | citations | medium | ??? |
Divs | fenced_divs | high | plugin |
Spans | bracketed_spans | high | ??? |
For a list of plugins that are officially recommended by markdown-it
, see markdown-it#syntax-extensions.
^1: markdown-it does not support complex fenced code attributes like {#mycode .haskell .numberLines startFrom="100"}
, only simple haskell
^2: There needs to be a new line between html and markdown content, for more information see text below http://spec.commonmark.org/0.21/#example-139