Pandoc

Pandoc最新版是一款功能相当实用的文档转换软件，Pandoc最新版软件支持转换的格式非常多，常用的有 txt、docx、html、pdf、md、pptx等，Pandoc软件还可以在许多标记和文字处理格式之间进行转换，包括但不限于各种类型的Markdown、HTML、LaTeX和Word docx。

Pandoc软件介绍

      Pandoc官方版是一个Haskell库，用于将一种标记格式转换为另一种格式，也是一个使用该库的命令行工具。

      Pandoc可以在许多标记和文字处理格式之间进行转换，包括但不限于各种类型的Markdown、HTML、LaTeX和Word docx。有关输入和输出格式的完整列表，请参阅下面的-from和-to选项。Pandoc还可以生成PDF输出：请参见下面的创建PDF。

      Pandoc的增强版Markdown包括表格、定义列表、元数据块、脚注、引用、数学等语法。请看下面的Pandoc的Markdown。

      Pandoc有一个模块化的设计：它由一组读取器和一组写入器组成，前者解析给定格式的文本，并生成文档的本机表示(抽象语法树或AST)，后者将本机表示转换为目标格式。因此，添加一个输入或输出格式只需要添加一个阅读器或写入器即可。用户还可以运行自定义的pandoc过滤器来修改中间AST。

      由于pandoc对文档的中间表示方式不如它所转换的许多格式之间的表现力强，因此不应该期望每一种格式和每一种其他格式之间都能实现完美的转换。Pandoc试图保留文档的结构元素，但不保留格式细节，如边距大小。而且有些文档元素，如复杂的表格，可能不适合pandoc的简单文档模型。虽然从pandoc的Markdown到所有格式的转换都力求完美，但从比pandoc的Markdown更有表现力的格式转换可能会有损失。

Pandoc安装步骤

      1.在51下载站下载最新版软件包

      2.解压软件，运行“EXE.文件”

      3.双击打开,进入软件界面

      4. 此软件为绿色版，无需安装即可使用

Pandoc常用命令

      markdown 转换为 html：pandoc README.md -o README.html

      Markdown 转 word：pandoc README.md -o README.docx

      markdown 转换为 pdf：pandoc README.md –latex-engine=xelatex -o README.pdf(latex之前是双短横线)

Pandoc支持格式

      输入格式:

      Markdown、格式轻量级标记语言、HTML、ReStructuredText、LaTeX、OPML、Org-mode、DocBook、Office Open XML (Microsoft Word .docx)

      输出格式：

      Office Open XML(Microsoft Word .docx)、OpenDocument、HTML、Wiki markup、Adobe InDesign ICML文稿 ( Adobe InCopy文稿交换格式)、web-based slideshows、电子书(Epub格式等)、OPML多、种 TeX (以及 PDF).

常见问题

   转换后格式错乱（表格、列表、引用块异常）原因：原文档含 Pandoc 不支持的复杂格式，或未用 -s/--standalone 生成完整文档。解决：添加 -s 参数；简化原文档格式；转换为 JSON 格式调试定位问题。

   图片无法显示 / 路径错误原因：使用绝对路径，或图片与源文件不在同一目录。解决：改用相对路径（如 ./img/xxx.jpg）；确保图片文件夹与源文件同目录。

   批量转换文件失败原因：命令语法错误、权限不足或文件路径含特殊字符。解决：Linux/macOS 用 for f in *.md; do pandoc "$f" -s -o "${f%.md}.pdf"; done；Windows PowerShell 用对应批量命令。