markdown转pdf,Pandoc项目

摘要: 本文记录 Markdown 转 pdf 的方法

【对数据分析、人工智能、金融科技、风控服务感兴趣的同学，欢迎关注我哈，阅读更多原创文章】
我的网站：潮汐朝夕的生活实验室
我的公众号：潮汐朝夕
我的知乎：潮汐朝夕
我的github：FennelDumplings
我的leetcode：FennelDumplings

---

Markdown 是程序员平时编写各类材料和文章时最喜欢的工具，但将其作为文档分发时却不好。因为不是所有人都了解 Markdown 的语法。而且在其它平台发布文章时，不如富文本文档，因为很多平台支持富文本但不支持 markdown。

因此对于 Markdown 文件，转换文件格式以便于分发普遍的需求。

• 对于离线分发，希望可以将 markdown 转换为 pdf
• 对于线上发布，希望可以将 markdown 转换为富文本

$1 Typora

用 Typora 打开 markdown 文件，然后 Export 为 pdf 文件。非常方便，此外还可以 Export 为 html, epub, docx 等常见格式。

这种方式可以处理 markdown 中的图片，公式。

$2 Pandoc

Pandoc 项目是格式转换的瑞士军刀，它可以将文档在 Markdown、LaTeX、HTML、docx 等多种标记格式之间相互转换，并支持输出 PDF、EPUB、HTML 等多种格式。

项目地址: https://www.pandoc.org/

在文章 jupyter notebook嵌入Hexo 中，我们解决了 jupyter notebook 嵌入 Hexo 页面这个需求，其中的方案1 就是依赖 pandoc 这个工具的。

安装

https://pandoc.org/installing.html，对于 Ununtu，可以直接从软件源安装:

sudo apt install pandoc

使用

pandoc <files> <options>

其中

• <files> 为输入的内容，其输入即可以来自文件，也可以来自标准输入甚至网页链接。
• <options> 为参数选项。

主要的参数选项

参数/选项	描述
-f <format>、-r <format>	指定输入文件格式，默认为 Markdown
-t <format>、-w <format>	指定输出文件格式，默认为 HTML
-o <file>	指定输出文件，该项缺省时，将输出到标准输出
--highlight-style <style>	设置代码高亮主题，默认为 pygments
-s	生成有头尾的独立文件（HTML，LaTeX，TEI 或 RTF）
-S	聪明模式，根据文件判断其格式
--self-contained	生成自包含的文件，仅在输出 HTML 文档时有效
--verbose	开启 Verbose 模式，用于 Debug
--list-input-formats	列出支持的输入格式
--list-output-formats	列出支持的输出格式
--list-extensions	列出支持的 Markdown 扩展方案
--list-highlight-languages	列出支持代码高亮的编程语言
--list-highlight-styles	列出支持的代码高亮主题
-v、--version	显示程序的版本号
-h、--help	显示程序的帮助信息

markdown 转 html

• 不包含任何样式

pandoc file.md -o file.html

• 转换时引入自己的层叠样式表 CSS 文件

pandoc file.md -c style.css -o file.html

• 外部文件嵌入到 HTML 文档中，生成一个自包含的独立文件

--self-contained 的意思是将任何的外部文件嵌入至输出的文件中，形成一个独立的 HTML 文档。这样传送资料时只传送一个文件就可以了，类似于 pdf。

pandoc file.md --self-contained -c style.css -o file.html

输出 docx

Pandoc 无法为生成的 docx 文档指定排版方式。需要二次编辑，将标题、正文等调整为满意的样式，然后再进行后续的转换或分发。

本地 markdown 转 docx

有一部分公式可以以图片的方式正确显示，有一些公式不能正确显示。

pandoc file.md -o file.docx

将在线的 html 页面转 docx

注意这种方式无法正确显示公式，并且会把不属于正式内容的部分也放进来。

pandoc https://.../...html -o page.docx

输出 pdf

可以直接生成 pdf，如果有公式，需要有 LaTeX 环境。

pandoc file.md -o file.pdf

也可以用过渡的方式

• Typora 打开(前面有提到)，然后导出 pdf
• 输出 html(前面有提到)，然后在浏览器打开，然后导出 pdf

转换为 markdown

以将任何支持的输入格式转换为 Markdown。注意 pdf 是无法直接转换为 markdown 的。

docx 转 markdown

pandoc file.docx -o file.md

html 转 markdown

注意 CSS 文件决定最终的显示样式

pandoc https://....

$3 md2all

之前用过 md2all 这个工具，可以在一定程度上解决用 markdown 写完一篇文章后在多个富文本平台发布的问题。详见 md2all。它的问题是对公式支持的不好。

---