pandoc使用
常规选项
指定输入格式
-f FORMAT, -r FORMAT, --from=FORMAT, --read=FORMAT
bibtex(BibTeX参考书目)biblatex(BibLaTeX 参考书目)commonmark(CommonMark Markdown)commonmark_x(带有扩展的CommonMark Markdown)creole(克里奥尔语 1.0)csljson(CSL JSON参考书目)csv(CSV表格)tsv(TSV 表)docbook(文档书)docx(Word文档)dokuwiki(DokuWiki 标记)endnotexml(EndNote XML 参考书目)epub(EPUB)fb2(FictionBook2 电子书)gfm( GitHub 风格的 Markdown ),或已弃用且不太准确的markdown_github;markdown_github仅当您需要gfm.haddock(黑线鳕标记)html(HTML)ipynb(Jupyter 笔记本)jats(JATS XML)jira(Jira /Confluence wiki 标记)json(原生 AST 的 JSON 版本)latex(乳胶)markdown( Pandoc 的 Markdown )markdown_mmd(多Markdown)markdown_phpextra( PHP Markdown 额外)markdown_strict(原始未扩展的Markdown)mediawiki(MediaWiki 标记)man(罗夫·曼)muse(缪斯)native(哈斯克尔原生)odt(ODT)opml(OPML)org(Emacs 组织模式)ris(RIS 参考书目)rtf(富文本格式)rst(重构文本)t2t(txt2标签)textile(纺织)tikiwiki(TikiWiki 标记)twiki(TWiki 标记)typst(打字员)vimwiki(维姆维基)- 自定义Lua阅读器的路径,请参阅 下面的自定义阅读器和编写器
+EXTENSION可以通过将或附加-EXTENSION到格式名称来单独启用或禁用扩展 。有关扩展及其名称的列表,请参阅下面的扩展。请参阅下面的--list-input-formats和--list-extensions。
指定输出格式
-t FORMAT, -w FORMAT, --to=FORMAT, --write=FORMAT
asciidoc(由AsciiDoctor解释的现代AsciiDoc)asciidoc_legacy(AsciiDoc由 解释asciidoc-py)。asciidoctor(已弃用的同义词asciidoc)beamer(LaTeX 投影仪幻灯片放映)bibtex(BibTeX参考书目)biblatex(BibLaTeX 参考书目)chunkedhtml(多个链接的 HTML 文件的 zip 存档)commonmark(CommonMark Markdown)commonmark_x(带有扩展的CommonMark Markdown)context(上下文)csljson(CSL JSON参考书目)docbook或docbook4(DocBook 4)docbook5(文档书 5)docx(Word文档)dokuwiki(DokuWiki 标记)epub或epub3(EPUB v3 书)epub2(EPUB v2)fb2(FictionBook2 电子书)gfm( GitHub 风格的 Markdown ),或已弃用且不太准确的markdown_github;markdown_github仅当您需要gfm.haddock(黑线鳕标记)html或html5(HTML,即 HTML5 /XHTML多语言标记)html4(XHTML 1.0 过渡)icml(InDesign ICML)ipynb(Jupyter 笔记本)jats_archiving(JATS XML、归档和交换标签集)jats_articleauthoring(JATS XML,文章创作标签集)jats_publishing(JATS XML,期刊出版标签集)jats(别名jats_archiving)jira(Jira /Confluence wiki 标记)json(原生 AST 的 JSON 版本)latex(乳胶)man(罗夫·曼)markdown( Pandoc 的 Markdown )markdown_mmd(多Markdown)markdown_phpextra( PHP Markdown 额外)markdown_strict(原始未扩展的Markdown)markua(马库亚)mediawiki(MediaWiki 标记)ms(罗夫女士)muse(缪斯)native(哈斯克尔原生)odt(OpenOffice 文本文档)opml(OPML)opendocument(开放文档)org(Emacs 组织模式)pdf(PDF)plain(纯文本)pptx(PowerPoint 幻灯片放映)rst(重构文本)rtf(富文本格式)texinfo(GNU 文本信息)textile(纺织)slideous(Slideous HTML 和 JavaScript 幻灯片放映)slidy(Slid HTML 和 JavaScript 幻灯片放映)dzslides( DZSlides HTML5 + JavaScript 幻灯片放映)revealjs(reveal.js HTML5 + JavaScript 幻灯片放映)s5(S5 HTML 和 JavaScript 幻灯片放映)tei(TEI 简单)typst(打字员)xwiki(XWiki 标记)zimwiki(ZimWiki 标记)- 自定义Lua writer的路径,请参阅 下面的自定义读者和作家
请注意odt,docx、epub、 和pdf输出不会定向到stdout,除非用 强制-o -。
+EXTENSION可以通过将或附加-EXTENSION到格式名称来单独启用或禁用扩展 。有关扩展及其名称的列表,请参阅下面的扩展。请参阅下面的--list-output-formats和 --list-extensions。
生成文件
-o FILE, --output=FILE
将输出写入FILE而不是stdout。如果 FILE为-,输出将转到stdout ,即使指定了非文本格式 ( docx, odt, epub2, )。epub3如果输出格式是chunkedhtml并且FILE 没有扩展名,那么.zippandoc 将创建一个目录FILE并在其中解压 zip 存档,而不是生成文件(除非 FILE已存在,在这种情况下将引发错误)。
--data-dir=目录
指定用户数据目录来搜索pandoc数据文件。如果未指定此选项,将使用默认的用户数据目录。在 *nix 和 macOS 系统上,这将是 pandocXDG 数据目录的子目录(默认情况下,$HOME/.local/share可通过设置环境变量覆盖XDG_DATA_HOME)。如果该目录不存在并且$HOME/.pandoc存在,则将使用该目录(为了向后兼容)。在 Windows 上,默认用户数据目录是%APPDATA%\pandoc. 您可以通过查看 的输出来找到系统上的默认用户数据目录pandoc --version。放置在此目录中的数据文件(例如,reference.odt, reference.docx, epub.css,templates) 将覆盖 pandoc 的正常默认值。(请注意,用户数据目录不是由 pandoc 创建的,因此如果您想使用它,您需要自己创建它。)
最后更新于 2026-02-18 18:09