Pandoc系列 - 1. 安装和基本语法

1. windows 系统安装 Pandoc

  • 下载地址：Pandoc 下载
  • 安装步骤：
    • 双击下载的安装包，按照提示进行安装。
    • 安装完成后，打开命令提示符（CMD）或 PowerShell，输入 pandoc -v 查看安装是否成功。

2 命令行使用 Pandoc

  • 基本命令：
    • pandoc -s input.md -o output.pdf：将 input.md 转换为 output.pdf。
    • pandoc -s input.md -o output.html：将 input.md 转换为 output.html。
    • pandoc -s input.tex -o output.docx：将 input.tex 转换为 output.docx。

说明： - -o output.pdf 的作用：指定输出文件名和格式。 - 删掉 -o output.pdf，Pandoc 会把结果输出到命令行，不会自动生成 output.pdf - -o 不可以删除：pandoc -s input.md output.pdf 不会把 output.pdf 当成“输出文件名”，而是当成第二个输入文件来处理 - 如果当前目录下本来就有一个 output.pdf 文件，Pandoc 会把它当成一个要读取的 md 文件去解析（基本上会是乱码/报错） - 如果没有这个文件，会直接报错：找不到文件 output.pdf。 - -s = --standalone 的作用：生成一个完整的独立文档（有必要的前导、头部等），而不是一个“片段”。 - 必须使用 -s 或 --standalone：转换为 HTML 时，需要包含必要的 <head>、<body> 等标签。 - 可以删掉 -s 或 --standalone：转换为 PDF 或 DOCX 等格式时，通常会自动按“独立文档”处理，所以加不加 -s 多数情况下效果一样。例如 

1
2
pandoc -s input.md -o output.pdf
pandoc input.md -o output.pdf
很多时候效果是一样的，都能得到一个正常的 PDF。

总结

  • -o output.pdf：不建议删，否则不会自动生成 pdf 文件。
  • -o 不可以删除
  • -s：在 md → pdf 这种用法中，多数情况下可以删，效果一样；保留也没坏处，是比较保险的写法。

2. conda 创建 python 环境

1
conda create -n pandoc_py310 python=3.10

激活环境 

1
conda activate pandoc_py310

2.1 pip 安装 pandoc 插件

1
pip install pandocfilters
software > Pandoc
#software #Pandoc
Pandoc系列 - 1. 安装和基本语法
http://yylustb.github.io/2025/11/19/software/Pandoc/Pandoc_1/
作者
yylustb
发布于
2025年11月19日
许可协议