Summary
Converts Markdown files to professionally formatted PDFs with Apple's design aesthetic. Built on WeasyPrint and markdown2, it automatically generates a cover page, clickable table of contents, and handles code blocks, tables, and standard Markdown syntax without breaking layouts across pages. The catch is your headings need to follow a specific numbering format (like "## 1. Chapter Title" and "### 1.1 Section") or the TOC generation fails. Nice touch: it uses SF fonts, handles orphan/widow control, and keeps code blocks intact during pagination. Created by huashu, who's known for shipping polished dev tools. Best for technical docs, whitepapers, or tutorials where you want that clean, book-quality output without wrestling with LaTeX.
Install to Claude Code
npx -y skills add alchaincyf/huashu-skills --skill huashu-md-to-pdf --agent claude-codeInstalls into .claude/skills of the current project.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Files
SKILL.mdView on GitHub
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 第二节
## 2. 第二章
### 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》
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
