SuperAPI AI 工具集

markdown-to-pdf

办公与效率

查看项目

更新于 10-16 00:02

技能介绍

用途:把已完成的 Markdown 报告转换为 PDF,使用 pandoc 配合 xelatex 引擎,排版面向分析型输出。

主要能力:支持 pandoc 风格编号脚注(正文 text.[^1],文末 [^1]: ... 定义);支持 YAML front matter 中的 title、subtitle、date 字段,渲染进标题块。固定排版参数为 letter 纸、1 英寸页边距、11pt 正文、1.2 行距、超链接全黑。

使用方式:技能假定 pandoc 与 LaTeX 引擎已在 PATH 上,不负责安装。缺失时按提示一次性安装。macOS:brew install pandoc basictex;sudo tlmgr update --self;sudo tlmgr install xetex。Linux(Debian/Ubuntu):sudo apt install pandoc texlive-xetex texlive-fonts-recommended。安装后需开新 shell 使 xelatex 进入 PATH。流程为:确认输入文件存在、检查 pandoc(command -v pandoc)、检查 xelatex(command -v xelatex)、按需创建输出目录、执行渲染命令、用 test -s <OUTPUT_PDF> 确认输出非空并报告路径。渲染命令为:pandoc <INPUT_MD> --from markdown+footnotes+yaml_metadata_block --pdf-engine=xelatex --output <OUTPUT_PDF> --variable geometry:margin=1in --variable papersize=letter --variable fontsize=11pt --variable linestretch=1.2 --variable colorlinks=true --variable linkcolor=black --variable urlcolor=black --variable toccolor=black。

适用场景:需要正式、可打印的分析报告 PDF。

限制:不自动安装 pandoc 或 LaTeX,不修改用户机器,不修改输入 Markdown,也不做任何预处理;pandoc 返回成功但输出缺失或为空时视为渲染失败并展示 stderr。basictex 约 90 MB,除非确需完整 LaTeX 栈(约 5 GB)否则不建议装 mactex。其他平台与更多细节暂未提供。