将 Markdown 文件导出成 PDF 格式
source link: https://blog.triplez.cn/posts/markdown-file-to-pdf-format/
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
前言#
因为最近要做课程有关的一些实验，有了写实验报告的需求。这些代码性的实验报告自然就直接用 Markdown 来编写啦~ 然后问题来了，由于是实验报告，会含有很多的数学公式以及图表，一般性的 Markdown 导出工具是不支持渲染 LaTeX 语法的数学公式的，所以导出来的效果非常差。
有了需求自然就要去想实现。经过一番搜索，发现了 Pandoc + MikTex + Markdown 这个理想的组合。于是，就开始了漫长的配置之路……
配置 Pandoc#
Pandoc 官方的配置流程在 这里。
Windows#
安装 Pandoc#
-
在 Pandoc Releases 中下载最新版本的
pandoc-x.x.x.x-windos.msi并执行安装。 -
安装完成后，在命令行中输入
pandoc --version， 若出现版本号，则安装成功。
Pandoc本身是一个功能特别强大的文件格式转换器，能够支持markdown,reStructuredText,textile,HTML,DocBook,LaTeX,MediaWiki markup,TWiki markup,OPML,Emacs Org-Mode,Txt2Tags,Microsoft Word docx,LibreOffice ODT,EPUB,Haddock markup格式的转换。简直就是文件转换中的 “瑞士军刀”。
- 如果需要将文件转换成
PDF，则需要安装TeX编译器。在Windows下，推荐使用MikTeX。
安装 MikTeX#
-
在 这里 下载
MikTeX并安装。 -
安装好
MikTeX后，先使用MikTeX Update升级核心包。 -
升级好之后，打开
MikTeX Settings，找到Package->Language Support->Chinese, Japanese, Korean并打上勾，点击确定安装中文语言支持包。
这一步可能会需要设置代理，取决于连接的目标服务器。
Linux#
还没配，等着填坑
使用 Pandoc#
Markdown 文件导出 PDF#
pandoc source.md -o ouput.pdf --latex-engine=xelatex -V mainfont="Microsoft YaHei"
mainfont是字体名称，具体中文对照表可见 这里
常用中文字体的英文名称对照表
Chinese Name English Name
宋体 SimSun
微软雅黑 Microsoft YaHei
仿宋 FangSong
华文细黑 STXihei
本作品采用知识共享署名-相同方式共享 4.0 国际许可协议进行许可。
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK