SuperAPI AI 工具集

md-to-pdf

办公与效率

查看项目

更新于 10-15 22:40

技能介绍

用途:把 Markdown 文件转换为格式良好的 PDF,适合需要导出、渲染或转换 .md 文件的场景。

主要能力:使用 pandoc 配合 xelatex 生成 PDF,输出干净的无衬线排版,代码块带语法高亮;通过自定义 LaTeX 头文件让代码块长行在页内换行并显示续行标记。

前置依赖:pandoc(brew install pandoc)、basictex(brew install --cask basictex),以及 LaTeX 包:sudo tlmgr install fontspec unicode-math selnolig upquote microtype parskip xurl bookmark fancyvrb csquotes framed fvextra。

使用方式:核心命令为 pandoc INPUT.md -o OUTPUT.pdf,配合 --resource-path 指向图片所在目录、--pdf-engine=xelatex、-H 加载 wrap-code.tex,并用 -V 设置 mainfont、monofont、fontsize、geometry:margin=1in、colorlinks、linkcolor、urlcolor,以及 --syntax-highlighting=tango。

注意事项:--resource-path 必须指向 Markdown 中引用图片所在目录(相对路径),通常是 md 文件所在目录;macOS 可用 Helvetica Neue 与 Menlo,Linux 改用 DejaVu Sans / DejaVu Sans Mono,Windows 用 Segoe UI / Cascadia Code;Helvetica Neue 缺少部分字形(如 → U+2192),出现 Missing character 警告时可用 sed 预处理为数学符号;若输出目录不可写(如 ~/Downloads),先写入 $TMPDIR 再移动;tango 主题适合浅色背景,也可选 kate、monochrome、espresso、haddock、zenburn。