GeekIt

Pandoc命令速查

格式互转、输入输出控制、元数据与模板、图片资源、代码高亮、过滤器、PDF 中文排版、批量转换与报错排查等 128 条命令

共 128 条命令 · 10 类场景 · 点击右侧图标可复制

命令 / 片段说明复制
pandoc --version查看版本与内置的编译信息
pandoc --help查看全部参数,选项非常多
pandoc --list-input-formats列出支持的输入格式(含扩展)
pandoc --list-output-formats列出支持的输出格式
pandoc --list-extensions=markdown查看某格式可用的扩展开关
pandoc --list-highlight-styles列出代码高亮主题
pandoc --list-highlight-languages列出高亮支持的编程语言
apt install pandocDebian/Ubuntu 安装,PDF 还需 TeX 引擎
brew install pandocmacOS 安装
choco install pandocWindows 安装
pandoc lua -e "print(pandoc.types.Version)"确认内置 Lua 解释器可用,过滤器依赖它
pandoc 只做转换,PDF 依赖外部引擎这是排障时最关键的一条认知
命令 / 片段说明复制
pandoc input.md -o output.html最常见的转换,默认输出 HTML 片段
pandoc input.md -o output.html -s加上完整 HTML 骨架(head/body)
pandoc input.md -o output.docxMarkdown 转 Word
pandoc input.md -o output.pdf转 PDF,需要本地有 LaTeX 引擎
pandoc input.md -o output.epub生成电子书
pandoc input.md -o output.pptx按标题层级生成幻灯片
pandoc input.docx -o output.mdWord 转 Markdown,迁移文档常用
pandoc input.docx -o output.md --extract-media=./media同时把图片抽出来放 media 目录
pandoc input.html -o output.mdHTML 转 Markdown
pandoc input.rst -o output.mdreStructuredText 转 Markdown
pandoc -f markdown -t html input.md显式指定输入输出格式,不依赖后缀
pandoc -t plain input.md输出纯文本,去掉所有标记
pandoc -t gfm input.md输出 GitHub 风格 Markdown
pandoc -t native input.md输出 AST 表示,调试转换行为时看它
pandoc -t json input.md输出 JSON AST,可被程序处理后再转回
pandoc -f json -t html doc.json从 JSON AST 生成 HTML,做二次加工
pandoc -o output.md -t markdown_strict输出严格 Markdown,兼容老解析器
pandoc -o out.rtf input.md生成 RTF,部分老工具需要
命令 / 片段说明复制
pandoc -f markdown+grid_tables+footnotes input.md用 + 开启扩展,- 关闭扩展
pandoc -f markdown-smart input.md关闭智能引号,避免中文标点被替换
pandoc -t html5 -s input.md指定 HTML5 输出
cat input.md | pandoc -t html从标准输入读取
pandoc input.md > output.html输出到标准输出再重定向
pandoc input.md -o - | head -20-o - 显式输出到标准输出
pandoc --wrap=none input.md -o out.md不自动折行,保持长段落
pandoc --wrap=preserve input.md -o out.md保留源文件的换行方式
pandoc --columns=100 input.md -o out.md按 100 列折行
pandoc --eol=crlf input.md -o out.txt输出 Windows 换行
pandoc --ascii input.md -o out.txt非 ASCII 字符转义输出
pandoc --verbose input.md -o out.html输出调试信息,排查资源找不到
pandoc 默认按 UTF-8 处理GBK 文件需先 iconv 转码,否则中文乱码
命令 / 片段说明复制
--- title: 运维手册 author: 张三 date: 2026-11-04 ---文档顶部 YAML 元数据块,最常用的方式
pandoc -M title="运维手册" -s input.md -o out.html命令行传元数据,不污染源文件
pandoc --metadata-file=meta.yaml -s input.md -o out.html元数据放独立文件,便于批量复用
pandoc -V mainfont="Noto Serif" -s input.md -o out.html模板变量,具体可用变量取决于模板
pandoc --template=mytemplate.html -s input.md -o out.html使用自定义模板
pandoc -D html > default.html导出内置模板,改完再当自定义模板用
pandoc -D latex > default.latex导出 LaTeX 模板,定制 PDF 版式
pandoc --toc -s input.md -o out.html生成目录
pandoc --toc --toc-depth=3 -s input.md -o out.html控制目录层级
pandoc --number-sections -s input.md -o out.pdf章节自动编号
pandoc --shift-heading-level-by=-1 input.md整体调整标题层级,合并文档时常用
pandoc --reference-doc=ref.docx input.md -o out.docx套用已有 Word 样式(字体、页边距)
pandoc --reference-odt=ref.odt input.md -o out.odtODT 的样式参考文件
pandoc --epub-cover-image=cover.jpg input.md -o book.epub指定电子书封面
pandoc --epub-metadata=meta.xml input.md -o book.epub电子书元数据,影响书店展示
命令 / 片段说明复制
pandoc input.docx -o out.md --extract-media=./media把 docx 里的图片抽到本地目录
pandoc --resource-path=.:images input.md -o out.html指定图片搜索路径,避免找不到资源
pandoc -s --embed-resources --standalone input.md -o single.html图片与 CSS 内嵌,产出单文件 HTML
pandoc --self-contained input.md -o out.html旧参数,新版本已弃用,改用 --embed-resources
pandoc --default-image-extension=png input.md -o out.pdf图片未写后缀时补全扩展名
pandoc --extract-media=media input.docx -o out.md转换同时导出媒体,注意目录会覆盖
pandoc -V graphics=true -s input.md -o out.texLaTeX 模板里启用图片支持
图片用绝对路径或相对当前目录LaTeX 引擎对相对路径更敏感,出问题先换绝对路径
pandoc --file-scope input.md多文件时各自解析脚注与引用,避免冲突
PDF 中图片过大时先压缩pandoc 不会自动缩图,源文件体积直接决定产物大小
命令 / 片段说明复制
pandoc --highlight-style=tango input.md -o out.html指定高亮主题
pandoc --list-highlight-styles列出全部主题:pygments、kate、monochrome 等
pandoc --no-highlight input.md -o out.html关闭高亮,只保留代码块
```{.python} print("hi") ```标注语言,才能正确高亮
```{.bash numberLines=true} echo hi ```代码块属性控制行号与起始行
pandoc --syntax-definition=my.xml input.md -o out.html自定义语言的语法定义
pandoc --highlight-style=theme.theme input.md用自定义主题文件
PDF 中高亮依赖 LaTeX 宏包缺宏包时会退化为无高亮,看日志确认
文档里避免缩进式代码块围栏代码块可控性更好,转换也更稳定
命令 / 片段说明复制
pandoc --lua-filter=pagebreak.lua input.md -o out.docxLua 过滤器,官方推荐方式
pandoc -F pandoc-crossref -F pandoc-citeproc input.md外部过滤器链式调用(逐个处理 AST)
pandoc --citeproc --bibliography=refs.bib input.md -o out.pdf处理参考文献,替代旧 pandoc-citeproc
pandoc --citeproc --csl=ieee.csl --bibliography=refs.bib input.md指定引文样式(GB/T 7714 等)
pandoc --lua-filter=wordcount.lua input.md统计字数等自定义逻辑
pandoc lua -e "print(pandoc.utils.stringify(pandoc.Pandoc{}))"直接跑 Lua 片段,调试过滤器
pandoc --filter=./myfilter.py input.md兼容 pandocfilters 的老式外部过滤器
pandoc --lua-filter=./filters/*.lua支持通配符,按顺序执行
pandoc-crossref 需与 pandoc 版本匹配版本不匹配会直接报错,先对齐再升级
过滤器输出可再次被下游过滤器处理链路越长越难排查,尽量合并逻辑
命令 / 片段说明复制
pandoc input.md -o out.pdf --pdf-engine=xelatex中文文档首选 xelatex
pandoc input.md -o out.pdf --pdf-engine=xelatex -V CJKmainfont="Noto Sans CJK SC"指定中文字体,避免方块字
pandoc input.md -o out.pdf --pdf-engine=lualatexlualatex 对字体与宏包支持更灵活
pandoc input.md -o out.pdf --pdf-engine=weasyprintHTML 渲染成 PDF,免装 TeX,样式靠 CSS
pandoc input.md -o out.pdf --pdf-engine=wkhtmltopdf老牌 HTML 转 PDF 引擎,中文字体需系统已装
pandoc input.md -o out.pdf --pdf-engine=typst新版支持 typst,构建速度快
pandoc -V geometry:margin=2cm -V fontsize=11pt input.md -o out.pdf页边距与字号,LaTeX 变量通用
pandoc -V documentclass=ctexart input.md -o out.pdf --pdf-engine=xelatex用 ctex 文档类处理中文排版
pandoc --pdf-engine-opt=--enable-local-file-access input.md -o out.pdf给引擎传参,wkhtmltopdf 读本地资源时必要
pandoc -V linkcolor=blue -V urlcolor=blue input.md -o out.pdf控制链接颜色
pandoc --toc --number-sections input.md -o out.pdf生成带编号目录,正式文档标配
中文字体名必须与系统一致用 fc-list :lang=zh 查看可用中文字体名
LaTeX 报错先看 .logpandoc 只转交错误,真正原因在 LaTeX 日志里
命令 / 片段说明复制
for f in *.md; do pandoc "$f" -o "${f%.md}.html" -s; done批量转 HTML
for f in docs/*.md; do pandoc "$f" -o "out/$(basename "${f%.md}").docx"; done批量转 Word 并统一输出目录
find . -name "*.md" -exec pandoc {} -o {}.docx \;递归批量转换
pandoc ch1.md ch2.md ch3.md -o book.pdf --toc多文件合并成一本书
pandoc --file-scope ch1.md ch2.md -o book.html按文件独立解析,避免脚注编号冲突
pandoc book.md -o book.html --split-level=1按一级标题拆分成多个 HTML 文件
pandoc --track-changes=all input.docx -o out.md保留 Word 修订标记,评审场景用
pandoc --track-changes=accept input.docx -o out.md接受全部修订后再转换
make docs把转换命令写进 Makefile,避免每次手敲长参数
pandoc --lua-filter=wordcount.lua *.md -o all.txt多输入时过滤器会作用在合并后的 AST 上
参数多的项目用 defaults 文件pandoc --defaults=book.yaml,集中管理所有选项
CI 中固定 pandoc 版本不同版本模板与默认值有差异,产物会变
命令 / 片段说明复制
pandoc: xelatex not found. Please select a different --pdf-engine缺 TeX 引擎,装 texlive 或改用 weasyprint
! Package inputenc Error: Unicode characterpdflatex 不支持中文,换 xelatex 或 lualatex
Could not find data file templates/default.latex数据目录缺失,检查安装是否完整或 PANDOC_DATA_DIR
--self-contained has been deprecated改用 --embed-resources --standalone
Unknown input format格式名拼错,用 --list-input-formats 核对
Unknown output format同上,输出格式不在支持列表中
Error parsing YAML metadataYAML 块缩进或引号有误,冒号后要空格
WARNING: This document format requires a nonempty <title>加 -s 并给 title,否则 HTML 头部为空
docx 转 md 后图片路径失效忘加 --extract-media,需重新转换
PDF 中文变成方块或缺字字体未嵌入,指定 CJKmainfont 或用 ctex
PDF 图片找不到加 --resource-path 或改用绝对路径
lua filter 报 attempt to index a nil valueAST 结构与预期不符,先 dump 看实际节点
pandoc-crossref 版本不匹配与 pandoc 大版本对齐,升级时一起升
转换后格式错乱用 -t native 看 AST,确认是解析阶段还是渲染阶段的问题
大文档转换很慢图片过多或过滤链过长,先裁剪再定位瓶颈
Windows 下中文乱码确认输入文件编码为 UTF-8,控制台代码页不影响产物

运维常用组合

Markdown 转 Wordpandoc report.md -o report.docx --reference-doc=template.docx --toc --number-sections
中文 PDFpandoc doc.md -o doc.pdf --pdf-engine=xelatex -V CJKmainfont="Noto Sans CJK SC" -V geometry:margin=2cm --toc
单文件 HTMLpandoc doc.md -o doc.html -s --embed-resources --standalone --highlight-style=tango
Word 转 Markdownpandoc spec.docx -o spec.md --extract-media=./media --wrap=none
合并成书pandoc ch1.md ch2.md ch3.md -o book.epub --toc --toc-depth=2 --epub-cover-image=cover.jpg
批量转换for f in docs/*.md; do pandoc "$f" -s -o "out/$(basename "${f%.md}").html"; done

实战要点

1. 记住 -f 与 -t

显式指定输入输出格式,比依赖文件后缀更可靠,也便于加扩展开关

2. HTML 要加 -s

不加 -s 只输出片段,没有 head 与样式,直接打开会很难看

3. PDF 先选引擎

中文优先 xelatex 或 typst,不想装 TeX 就用 weasyprint

4. 样式用 reference-doc

Word 排版靠参考文档继承样式,比手改输出文件高效得多

5. 复杂需求写 defaults

把长参数放进 yaml defaults 文件,命令短且可版本管理

6. 转换出错先看 AST

用 -t native 输出中间表示,能快速定位是解析还是渲染问题

共 128 条 Pandoc 命令 · 示例中的文件名、字体与路径请替换为实际环境

关于Pandoc命令速查

在线 Pandoc 命令速查手册,按安装与版本、基础格式转换、输入输出与编码、元数据与模板、资源与图片、代码高亮、过滤器与扩展、PDF 引擎与中文、批量转换与脚本、常见报错与排查等 10 类场景整理 120 余条常用命令与参数组合,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 pandoc --version 与 --list-input-formats/--list-output-formats/--list-extensions/--list-highlight-styles/--list-highlight-languages 与 apt/brew/choco 安装、pandoc input.md -o output.html 与 -f/-t 指定格式与 -s 独立文档 与 -o docx/pdf/epub/pptx/rst 与 -t plain/gfm/native/json 与 --reference-doc 与 --toc/--toc-depth 与 --number-sections 与 --shift-heading-level-by、-f markdown+grid_tables 扩展开关 与 stdin/stdout 管道 与 --wrap=auto|none|preserve 与 --columns 与 --eol 与 --ascii、YAML metadata 块与 --metadata/-M 与 --metadata-file 与 -V 模板变量 与 --template 与 pandoc -D html 导出默认模板、--extract-media 提取 docx 图片 与 --resource-path 与 --embed-resources --standalone 单文件 HTML 与 --default-image-extension、--highlight-style 与 --no-highlight 与 --syntax-definition 与代码块属性、--lua-filter 与 -F 外部过滤器 与 --citeproc 与 --bibliography 与 --csl 与 pandoc-crossref 与 pandoc lua -e、--pdf-engine=xelatex/lualatex/weasyprint/wkhtmltopdf/typst 与 -V CJKmainfont 中文字体 与 -V geometry:margin=2cm 与 --pdf-engine-opt,以及 for 循环批量转换、find -exec、Makefile、多文件合并成书、--file-scope 与 --split-level 分章节输出、--track-changes=all 处理修订,还有 xelatex not found、Unicode character 报错、Could not find data file templates、--self-contained 已弃用(改 --embed-resources)、Unknown input/output format、YAML metadata 解析失败、缺少 title 的警告、docx 图片未提取、PDF 中文缺字、lua filter 报错 等排查。适用于 Markdown 转 Word/PDF/HTML、技术文档与书籍排版、docx 提取图片与批量转 Markdown、幻灯片与电子书生成、CI 中文档构建与模板复用,以及运维、技术写作与后端工程师面试复习。

核心能力

  • 涵盖 pandoc --version 与 --list-input-formats/--list-output-formats/--list-extensions/--list-highlight-styles/--list-highlight-languages 与 apt/brew/choco 安装、pandoc input.md -o output.html 与 -f/-t 指定格式与 -s 独立文档 与 -o docx/pdf/epub/pptx/rst 与 -t plain/gfm/native/json 与 --reference-doc 与 --toc/--toc-depth 与 --number-sections 与 --shift-heading-level-by、-f markdown+grid_tables 扩展开关 与 stdin/stdout 管道 与 --wrap=auto|none|preserve 与 --columns 与 --eol 与 --ascii、YAML metadata 块与 --metadata/-M 与 --metadata-file 与 -V 模板变量 与 --template 与 pandoc -D html 导出默认模板、--extract-media 提取 docx 图片 与 --resource-path 与 --embed-resources --standalone 单文件 HTML 与 --default-image-extension、--highlight-style 与 --no-highlight 与 --syntax-definition 与代码块属性、--lua-filter 与 -F 外部过滤器 与 --citeproc 与 --bibliography 与 --csl 与 pandoc-crossref 与 pandoc lua -e、--pdf-engine=xelatex/lualatex/weasyprint/wkhtmltopdf/typst 与 -V CJKmainfont 中文字体 与 -V geometry:margin=2cm 与 --pdf-engine-opt,以及 for 循环批量转换、find -exec、Makefile、多文件合并成书、--file-scope 与 --split-level 分章节输出、--track-changes=all 处理修订,还有 xelatex not found、Unicode character 报错、Could not find data file templates、--self-contained 已弃用(改 --embed-resources)、Unknown input/output format、YAML metadata 解析失败、缺少 title 的警告、docx 图片未提取、PDF 中文缺字、lua filter 报错 等排查

适用场景

适用于 Markdown 转 Word/PDF/HTML、技术文档与书籍排版、docx 提取图片与批量转 Markdown、幻灯片与电子书生成、CI 中文档构建与模板复用,以及运维、技术写作与后端工程师面试复习。Pandoc命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

Pandoc命令速查是免费的吗?需要注册或安装吗?
Pandoc命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
Pandoc命令速查支持哪些功能?
涵盖 pandoc --version 与 --list-input-formats/--list-output-formats/--list-extensions/--list-highlight-styles/--list-highlight-languages 与 apt/brew/choco 安装、pandoc input.md -o output.html 与 -f/-t 指定格式与 -s 独立文档 与 -o docx/pdf/epub/pptx/rst 与 -t plain/gfm/native/json 与 --reference-doc 与 --toc/--toc-depth 与 --number-sections 与 --shift-heading-level-by、-f markdown+grid_tables 扩展开关 与 stdin/stdout 管道 与 --wrap=auto|none|preserve 与 --columns 与 --eol 与 --ascii、YAML metadata 块与 --metadata/-M 与 --metadata-file 与 -V 模板变量 与 --template 与 pandoc -D html 导出默认模板、--extract-media 提取 docx 图片 与 --resource-path 与 --embed-resources --standalone 单文件 HTML 与 --default-image-extension、--highlight-style 与 --no-highlight 与 --syntax-definition 与代码块属性、--lua-filter 与 -F 外部过滤器 与 --citeproc 与 --bibliography 与 --csl 与 pandoc-crossref 与 pandoc lua -e、--pdf-engine=xelatex/lualatex/weasyprint/wkhtmltopdf/typst 与 -V CJKmainfont 中文字体 与 -V geometry:margin=2cm 与 --pdf-engine-opt,以及 for 循环批量转换、find -exec、Makefile、多文件合并成书、--file-scope 与 --split-level 分章节输出、--track-changes=all 处理修订,还有 xelatex not found、Unicode character 报错、Could not find data file templates、--self-contained 已弃用(改 --embed-resources)、Unknown input/output format、YAML metadata 解析失败、缺少 title 的警告、docx 图片未提取、PDF 中文缺字、lua filter 报错 等排查。
Pandoc命令速查适合哪些场景使用?
适用于 Markdown 转 Word/PDF/HTML、技术文档与书籍排版、docx 提取图片与批量转 Markdown、幻灯片与电子书生成、CI 中文档构建与模板复用,以及运维、技术写作与后端工程师面试复习。