Pandoc
########################################

指定输出格式
****************************************

对于某些格式而言，其可能具有多种变体（比如 MarkDown ），我们可以使用 ``-t`` 选项指定某一种变体以获得更好的观感：

例如对于 rst 而言，其默认的 markdown 就会出现明显的格式错误，这时我们可以使用 gfm 变体：

.. code-block:: shell

   pandoc 1.rst -t gfm -o 1.md

对于 markdown 而言，其变体有：

.. csv-table::
   :header: 变体, 变体说明

   commonmark        , `CommonMark  <https://commonmark.org/>`_
   commonmark_x      , CommonMark Markdown with extensions
   gfm               , `Github Flavored Markdown <https://help.github.com/articles/github-flavored-markdown/>`_
   markdown (默认)   ,  `Pandoc's Markdown <https://pandoc.org/MANUAL.html#pandocs-markdown>`_
   markdown_mmd      , `MultiMarkdown <https://fletcherpenney.net/multimarkdown/>`_
   markdown_phpextra , `PHP Markdown Extra <https://michelf.ca/projects/php-markdown/extra/>`_
   markdown_strict   , `原始无拓展的 Markdown <https://daringfireball.net/projects/markdown/>`_

一般而言， 对于 Python 工具链而言， CommonMark 是支持最广泛的语法，但是对于各种应用软件而言，GFM 已经成为事实上的标准。


.. seealso::

   - `Pandoc 支持的输出格式 <https://pandoc.org/MANUAL.html#option--to>`_
   - `A better way to transform Note, Warning blocks in rst to markdown <https://github.com/jgm/pandoc/issues/7268#issuecomment-833638062>`_