Markdown to PDF Skill 将 Markdown 文档转换为专业的苹果设计风格 PDF 白皮书。 核心功能 专业排版 ：书籍级排版质量，自动处理分页、孤行寡行 苹果设计 ：SF 字体系统、现代简洁风格、专业配色 完整目录 ：自动提取章节结构，双列布局，可点击跳转 Markdown 完美支持 ：代码块、表格、引用、列表等全部正确渲染 使用方法 基础用法

转换单个文件

python scripts/convert.py input.md

指定输出文件名

python scripts/convert.py input.md -o "我的白皮书.pdf"

自定义标题和作者

python scripts/convert.py input.md --title "技术白皮书" --author "花叔" Markdown 文档要求 你的 Markdown 文档应该遵循以下结构：

文档标题

1. 第一章

1.1 第一节

1.2 第二节

1. 第二章

2.1 第一节 关键规则 ： 主章节：

1. 标题

（数字 + 点 + 空格 + 标题） 子章节：

1.1 标题

（数字.数字 + 空格 + 标题） 这样才能正确提取目录 设计特点 封面设计 淡灰色渐变背景 大标题：64pt，简洁现代 副标题和元信息 目录设计 双列布局，单页展示 主章节粗体，子章节缩进 可点击跳转到对应章节 正文排版 SF 字体系列（苹果设计语言） 行高 1.7，舒适阅读 章节自动分页 孤行寡行控制 代码块 浅灰背景 + 细边框 圆角 8px SF Mono 等宽字体 自动避免分页 表格 清晰网格线 浅灰表头 自动保留表头（长表格分页时） 配置选项 如果需要自定义样式，可以修改 scripts/convert.py 中的 CSS 变量：

主色调

PRIMARY_COLOR

'#06c'

苹果蓝

TEXT_COLOR

'#1d1d1f'

主文本黑色

GRAY_COLOR

'#86868b'

浅灰色

字体大小

COVER_TITLE_SIZE

'64pt' H2_SIZE = '22pt' H3_SIZE = '17pt' BODY_SIZE = '11pt' 常见问题 Q: 目录为什么是空的？ A: 确保你的 Markdown 使用了正确的章节格式：

1. 标题

而不是

标题

1.1 标题

而不是

标题

Q: 代码块显示不正确？ A: 确保使用三个反引号包裹：

python
def
hello
(
)
:
print
(
"Hello"
)

Q: 表格格式乱了？ A: 使用标准的 Markdown 表格语法： | 列1 | 列2 | |

|

| | 值1 | 值2 | Q: 如何修改字体？ A: 编辑 scripts/convert.py 中的 CSS，修改 font-family 属性。 Q: 生成的 PDF 太大？ A: 检查是否有大量图片，考虑压缩图片或使用外链。 依赖安装 首次使用需要安装 Python 依赖： pip3 install markdown2 weasyprint 如果遇到 WeasyPrint 安装问题（macOS）： brew install pango pip3 install weasyprint 示例 生成技术文档 python scripts/convert.py tech-guide.md -o "技术指南.pdf" 生成白皮书 python scripts/convert.py whitepaper.md --title "产品白皮书" --author "团队" 脚本说明 scripts/convert.py - 主转换脚本 scripts/styles.css - CSS 样式定义（已嵌入脚本） templates/cover.html - 封面模板（已嵌入脚本） 技术实现 本 Skill 使用： markdown2 ：Markdown 解析（支持扩展语法） WeasyPrint ：HTML to PDF 转换（支持 CSS3） 苹果设计系统 ：SF 字体、专业配色、现代排版 更新日志 v1.0 (2025-12-24) 初始版本 支持完整 Markdown 语法 苹果设计风格 自动目录生成 书籍级排版质量 花叔出品 | AI Native Coder · 独立开发者 公众号「花叔」| 30万+粉丝 | AI工具与效率提升 代表作：小猫补光灯（AppStore付费榜Top1）·《一本书玩转DeepSeek》