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 pandoc | Debian/Ubuntu 安装,PDF 还需 TeX 引擎 | |
brew install pandoc | macOS 安装 | |
choco install pandoc | Windows 安装 | |
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.docx | Markdown 转 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.md | Word 转 Markdown,迁移文档常用 | |
pandoc input.docx -o output.md --extract-media=./media | 同时把图片抽出来放 media 目录 | |
pandoc input.html -o output.md | HTML 转 Markdown | |
pandoc input.rst -o output.md | reStructuredText 转 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.odt | ODT 的样式参考文件 | |
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.tex | LaTeX 模板里启用图片支持 | |
图片用绝对路径或相对当前目录 | 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.docx | Lua 过滤器,官方推荐方式 | |
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=lualatex | lualatex 对字体与宏包支持更灵活 | |
pandoc input.md -o out.pdf --pdf-engine=weasyprint | HTML 渲染成 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 报错先看 .log | pandoc 只转交错误,真正原因在 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 character | pdflatex 不支持中文,换 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 metadata | YAML 块缩进或引号有误,冒号后要空格 | |
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 value | AST 结构与预期不符,先 dump 看实际节点 | |
pandoc-crossref 版本不匹配 | 与 pandoc 大版本对齐,升级时一起升 | |
转换后格式错乱 | 用 -t native 看 AST,确认是解析阶段还是渲染阶段的问题 | |
大文档转换很慢 | 图片过多或过滤链过长,先裁剪再定位瓶颈 | |
Windows 下中文乱码 | 确认输入文件编码为 UTF-8,控制台代码页不影响产物 |
运维常用组合
pandoc report.md -o report.docx --reference-doc=template.docx --toc --number-sectionspandoc doc.md -o doc.pdf --pdf-engine=xelatex -V CJKmainfont="Noto Sans CJK SC" -V geometry:margin=2cm --tocpandoc doc.md -o doc.html -s --embed-resources --standalone --highlight-style=tangopandoc spec.docx -o spec.md --extract-media=./media --wrap=nonepandoc ch1.md ch2.md ch3.md -o book.epub --toc --toc-depth=2 --epub-cover-image=cover.jpgfor 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 输出中间表示,能快速定位是解析还是渲染问题
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 中文档构建与模板复用,以及运维、技术写作与后端工程师面试复习。