素材阁

Pandoc 速查

共 25 条 Pandoc 文档转换用法,涵盖基础转换、常用场景、常用选项、过滤器与引用、其它用法。 支持搜索与分类筛选,点击即可复制。

基础转换

格式由输入输出推断,也可显式指定。

命令说明
Markdown 转 HTML
显式指定输入/输出格式
Markdown 转 Word
Word 转 Markdown
转 PDF(需 LaTeX)
查看支持的格式列表

常用场景

文档、幻灯片与讲义。

命令说明
生成完整(独立)HTML 文档
生成网页幻灯片
生成电子书
合并多个文件
用参考文档套用样式

常用选项

排版与目录。

命令说明
生成目录
独立文档并自动编号章节
代码高亮样式
PDF 中文字体
设置元数据(标题等)
PDF 边距设置

过滤器与引用

扩展能力。

命令说明
Lua 过滤器(自定义处理 AST)
引用处理(旧版)
新版引用处理
自定义输出模板

其它用法

管道与调试。

命令说明
标准输入/stdout 管道(转纯文本)
去掉格式转纯文本
导出默认模板作为改写起点
把样式/图片内联进 HTML

使用说明

Pandoc 速查:基础转换、常用场景、常用选项、过滤器与引用、其它用法;支持搜索与分类筛选,点击即可复制。

  1. 按用途点分类:基础转换、常用场景、常用选项、过滤器与引用、其它用法。
  2. 点「命令」列复制到终端。
  3. 格式通常由输入/输出后缀自动推断,也可用 -f/-t 显式指定。
  4. 转 PDF 需要本机有 LaTeX(xelatex),中文还要指定 CJK 字体。

常见问题

转 PDF 报错找不到引擎?
Pandoc 本身不生成 PDF,需要外部引擎(xelatex/wkhtmltopdf/typst 等);安装 TeX Live 后加 --pdf-engine=xelatex。
中文 PDF 字体乱码怎么办?
用 -V mainfont="Noto Sans CJK SC"(或其它 CJK 字体)指定中文字体,并用 xelatex 引擎。
需要联网吗?
不需要,本地可用。

延伸阅读

相关工具