Pandoc 文档转换速查指南：Quick Reference 项目详解安装、LaTeX 转 Word 与常用命令

Pandoc 文档转换速查指南Quick Reference 项目详解安装、LaTeX 转 Word 与常用命令【免费下载链接】reference面向开发者的技术速查清单Cheat Sheets集合整理常见技术、工具与开发流程帮助快速查阅关键信息提高开发效率。项目地址: https://gitcode.com/GitHub_Trending/referen/referencePandoc 是一款功能强大的命令行文档转换器只需一条命令即可在 Markdown、LaTeX、HTML、Docx、PDF、AsciiDoc 等数十种格式之间自由切换。本指南以 Quick Reference 仓库中的 Pandoc 备忘清单 为核心骨架完整覆盖多平台安装方式、LaTeX 转 Word 的引文与交叉引用实战、目录生成与过滤器等高频用法读完后你可以直接照抄命令完成日常文档转换任务。Pandoc 是什么一个命令行文档转换器Pandoc 是一个文档转换器Document Converter它的典型使用方式是在终端中执行一条pandoc命令把源文件转换成目标文件而具体转换为什么格式通常由输出文件的扩展名自动决定。这让它成为写作、排版、学术论文与博客发布流程中的瑞士军刀级工具。本仓库将其收录在 README.md 的命令分类下见 Pandoc 条目与ffmpeg、jq、sed等命令工具并列定位为一份随查随用的命令速查表。下文将逐条展开备忘清单中的命令并补充参数含义与适用前提方便你理解而非死记。基本语法一条命令完成转换Pandoc 最基本的调用形式如下$ pandoc -s [source file] -o [output file]其中两个核心参数-s/--standalone生成独立文档standalone document即包含完整文档头title、metadata、完整的html结构等的成品省略时默认输出的是片段fragment适合嵌入其他文档的场景。-o/--output指定输出文件名输出格式由文件扩展名推断。例如-o out.docx输出 Word 文档、-o out.html输出网页、-o out.pdf输出 PDF。这一条语法是后续所有示例的共同基础——变换的是输入输出文件以及附加的各种行为选项。安装 Pandoc覆盖主流操作系统备忘清单给出了不同平台的安装命令汇总如下| 安装命令 | 环境 | | :- | :- | |$ brew install pandoc| macOSHomebrew | |$ choco install pandoc| WindowsChocolatey |在 Linux 各主流发行版上Pandoc 已进入官方软件源可直接用包管理器安装Debian / Ubuntu$ sudo apt-get update $ sudo apt-get install pandoc先执行apt-get update刷新软件源索引再安装可避免因索引过期导致的安装失败。Fedora$ sudo dnf install pandocArch Linux$ sudo pacman -S pandoc需要注意的适用前提不同发行版软件源中的 Pandoc 版本可能滞后于最新版若需要--citeproc、新格式支持等较新特性建议查阅 Pandoc 官方文档了解各平台最新安装方式通过包管理器安装后可运行pandoc --version验证安装结果与版本号。实战将 LaTeX 转换为 MS WordLaTeX.tex与 Word.docx互转是 Pandoc 的高频场景备忘清单给出了四种由浅入深的用法。1. 简单的.tex到.docx转换$ pandoc -s file.tex -o file.docx-s生成包含文档结构的独立 Word 文档标题、章节、公式与表格会被转换为 Word 原生元素转换后可在 Word 中直接编辑。2. 使用默认引文Citation处理$ pandoc -s file.tex --citeproc --bibliographybib_library.bib -o file.docx--citeproc启用内置引文处理器把文中的[key]等引文标记渲染为规范的引用文本与参考文献列表。--bibliographybib_library.bib指定参考文献数据库Pandoc 原生支持 BibTeX.bib等常见格式。这一组合适合论文、专著等需要文献管理场景的 LaTeX 文档转换后文末会自动生成参考文献列表。3. 指定具体引文样式CSL$ pandoc -s file.tex --citeproc --bibliographybib_library.bib --cslapa.csl -o file.docx--cslapa.csl通过 CSLCitation Style Language样式文件控制引用与参考文献的排版风格。上例使用 APA 样式apa.csl换成其他.csl文件即可切换为 IEEE、Chicago、GB/T 7714 等不同期刊或机构要求的引用格式。当目标期刊对引用格式有硬性要求时这一步必不可少。4. 带交叉引用的转换$ pandoc -s file.tex --filter pandoc-crossref -o file.docx--filter pandoc-crossref调用pandoc-crossref外部过滤器处理交叉引用对图表、公式、章节进行编号与交叉引用如见图 3。pandoc-crossref是独立于 Pandoc 的第三方可执行程序需要单独安装安装后放到 PATH 中即可被--filter调用。常用转换场景从 Markdown 到各种格式转换文件格式Markdown 转 PDF$ pandoc input.md -o output.pdf以input.md为源、输出为 PDF。适用前提Pandoc 本身不直接渲染 PDF而是把文档转换为中间格式默认是 LaTeX后交给 LaTeX 引擎如pdflatex编译。因此本命令要求系统中已安装可用的 LaTeX 发行版若无 LaTeX 环境则需要配置其他 PDF 引擎如--pdf-engineweasyprint、--pdf-enginewkhtmltopdf。支持的输入格式纯文本转 HTML$ pandoc -s input.txt -o output.html-s在此处的作用是把input.txt转换并包装为一份完整的 HTML 文档含html、head、body结构可直接用浏览器打开。Pandoc 的输入格式非常丰富除了 Markdown、纯文本还包括 HTML、LaTeX、reStructuredText、Org-mode、Docx、EPUB 等。自定义输出格式显式指定--to$ pandoc input.md --tolatex -o output.tex--tolatex可简写为-t latex显式声明输出格式不依赖输出文件扩展名推断。同样的源文件将--to换成html、docx、markdown等即可输出对应格式适用于扩展名无法表达格式意图或需要强制指定格式的场景。添加元数据标题、作者与日期$ pandoc input.md -o output.pdf --metadata titleMy Document--metadata titleMy Document在文档头中注入键值对元数据。除了title常见的还有author、date等它们会被模板渲染到文档的标题区、页眉或元信息中。也可以使用--metadata-filemeta.yaml从 YAML 文件批量加载元数据适合元数据较多的文档。从 URL 直接转换$ pandoc https://example.com/document.md -o output.pdfPandoc 可以直接把 URL 作为输入源抓取远程的 Markdown 文档并转换。适用前提命令执行时所在主机需要能正常访问该 URL注意网络可达性与代理设置。生成幻灯片$ pandoc input.md -t beamer -o output.pdf-t beamer使用 LaTeX 的 Beamer 文档类生成 PDF 幻灯片。适用前提需要本地具备 LaTeX 环境。Beamer 幻灯片中Markdown 里的二级标题##通常对应每一页幻灯片的标题配合 Pandoc 的 YAML 头信息即可控制主题、字体等幻灯片外观。合并多个文件$ pandoc file1.md file2.md -o output.pdfPandoc 接受多个输入文件按命令行给出的顺序依次合并后统一转换常用于把分散的章节文件拼装成一篇完整文档。指定样式文件$ pandoc input.md -o output.pdf --cssstyle.css--cssstyle.css为支持 CSS 的输出格式如 HTML、EPUB指定外部样式表。需要说明的是默认的 PDFLaTeX 引擎路径下 CSS 不生效CSS 主要作用于 HTML / EPUB 输出若确需用 CSS 控制 PDF 外观应搭配--pdf-engineweasyprint等基于浏览器的 PDF 引擎。转换为 AsciiDoc$ pandoc input.md -o output.asciidoc输出扩展名asciidoc自动触发 AsciiDoc 格式适合需要把 Markdown 内容迁移到 AsciiDoc 文档体系如部分文档站点、书籍出版管线的场景。转换为 Docx 格式$ pandoc input.md -o output.docx把 Markdown 直接转为 Word 文档是写作用 Markdown、交付用 Word工作流的典型用法转换后可继续用 Word 审阅与批注。高级加工Lua 过滤器与目录控制执行 Lua 过滤器$ pandoc input.md --lua-filtercustom-filter.lua -o output.pdf--lua-filtercustom-filter.lua加载并执行一个 Lua 脚本过滤器。Lua 过滤器是 Pandoc 强大的可编程扩展机制在文档转换过程中过滤器可以遍历并修改内部的元素树如给所有代码块加边框、自动替换特定文本、对表格做后处理等。适用前提需本地安装 Lua 解释器且过滤器脚本语法与当前 Pandoc 版本兼容。自动生成目录TOC$ pandoc input.md -o output.pdf --toc--toc自动根据文档标题层级生成目录Table of Contents并按标题结构为正文生成编号。控制目录深度$ pandoc input.md -o output.pdf --toc --toc-depth2--toc-depth2指定目录包含的标题层级数--toc-depth2只收录一级与二级标题默认值为 3收录到三级标题。层级越深目录越细文档较长时收敛到 2 级目录更清爽这也是禁用/收敛目录编号的常用手段。调试与能力查询显示详细信息$ pandoc input.md -o output.pdf -v-v/--verbose输出详细的处理日志包括格式探测、过滤器调用、底层引擎执行情况等排查转换失败或行为不符合预期时非常有用。查看支持的输出格式$ pandoc --list-output-formats--list-output-formats列出当前 Pandoc 版本支持的全部输出格式名称是确认目标格式是否可用最直接的方式。类似的--list-input-formats可查看支持的输入格式清单。安装完 Pandoc 后先执行这两条命令就能清楚掌握本机版本的格式能力边界。关键参数速查表将本文涉及的核心参数汇总如下便于快速检索| 参数 | 含义 | 示例 | | :- | :- | :- | |-s/--standalone| 生成独立完整文档含文档头 |pandoc -s in.txt -o out.html| |-o/--output| 输出文件格式由扩展名推断 |-o output.docx| |-t/--to| 显式指定输出格式 |-t beamer、--tolatex| |--metadata| 注入文档元数据标题/作者/日期 |--metadata titleMy Document| |--citeproc| 启用内置引文处理器 |--citeproc --bibliographybib_library.bib| |--bibliography| 指定参考文献数据库文件 |--bibliographybib_library.bib| |--csl| 指定 CSL 引文样式文件 |--cslapa.csl| |--filter| 调用外部过滤器如 pandoc-crossref |--filter pandoc-crossref| |--lua-filter| 执行 Lua 过滤器脚本 |--lua-filtercustom-filter.lua| |--toc| 自动生成目录 |--toc| |--toc-depth| 目录收录的标题层级深度默认 3 |--toc-depth2| |--css| 为 HTML/EPUB 等输出指定样式表 |--cssstyle.css| |-v/--verbose| 输出详细处理日志 |-v| |--list-output-formats| 列出支持的输出格式 |--list-output-formats|在 Quick Reference 仓库中的定位与扩展阅读清单本体docs/pandoc.md 是本文的原始出处所有命令均可在其中逐条核对该文件属于仓库 docs 目录下的备忘清单之一。首页导航README.md 的命令分类中以Pandoc卡片链接到本文档标注其为文档转换器工具。写作输入搭配Pandoc 最常见的源格式是 Markdown可配合仓库中的 Markdown 备忘清单 掌握标题、列表、块引用、任务列表等语法再交给 Pandoc 转换成目标格式形成Markdown 写作 → Pandoc 排版的完整链路。生成机制本仓库通过refs-cli把docs/*.md编译为静态 HTML 速查页见 package.json 中的build/start脚本每篇备忘清单的排版与渲染均由此管线处理贡献与扩展方式可参考 CONTRIBUTING.md。注意事项与适用前提PDF 输出依赖外部引擎默认走 LaTeX 引擎需预装 LaTeX 发行版无 LaTeX 时可改用--pdf-engineweasyprint/wkhtmltopdf等此时--css才会生效。引文处理--citeproc为内置引文处理器老版本 Pandoc 需要--filter pandoc-citeproc的写法具体以当前pandoc --version的说明为准。过滤器为外部组件pandoc-crossref、Lua 过滤器脚本均需自行安装与维护与 Pandoc 主程序版本可能存在兼容性要求。URL 转换依赖网络从 URL 抓取内容时需保证网络可达。版本差异各发行版包管理器提供的 Pandoc 版本与特性集可能不同执行前可用pandoc --list-output-formats快速确认本机能力。【免费下载链接】reference面向开发者的技术速查清单Cheat Sheets集合整理常见技术、工具与开发流程帮助快速查阅关键信息提高开发效率。项目地址: https://gitcode.com/GitHub_Trending/referen/reference创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考