菜单
将 Markdown 文档转换为专业的 PDF 白皮书，采用苹果设计风格 (v2.0)。 v2.0 改进: - 使用 pdfkit + wkhtmltopdf 替代 WeasyPrint (避免 pango 依赖问题) - 支持 WebP 等特殊格式图片处理 - 自动处理无扩展名图片 - 提供完整的图片处理工具链 - 一键式工作流 支持完整的 Markdown 语法 (代码块、表格、引用、列表等)。 自动生成封面、目录、页眉页脚。 使用场景: 技术文档、白皮书、教程、报告等需要专业排版的 Markdown 文档。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
对 Markdown 学习笔记做结构重构与精修：两阶段 Plan-and-Execute 工作流——先诊断归类（出清单/大纲/映射/scaffold），再精修交付（重写正文、越界路由、资源追踪）。支持全文或指定章节两种 scope；支持只出清单或直接输出整理后正文。
文档写入协议（去躁点版）。控制 AI 何时写入文档、写入什么内容。当用户说"沉淀到文件"、"记录下来"、"update: xxx.md" 时使用。
PRD 渐进式维护协议。多供应商并行开发 + 敏捷迭代场景下维护 PRD 文档。当用户说"prd: path"、"维护 PRD"、"更新需求文档"时使用。依赖 docs-writing-protocol 的去躁点判定。
脚本化图片 alt/title 补全工具。脚本负责提取和替换，模型只负责看图生成描述。支持 Markdown 和 HTML 图片，严格不改路径、不丢图。
基于 SOC 职业分类
| name | markdown-to-pdf |
| description | 将 Markdown 文档转换为专业的 PDF 白皮书，采用苹果设计风格 (v2.0)。 v2.0 改进: - 使用 pdfkit + wkhtmltopdf 替代 WeasyPrint (避免 pango 依赖问题) - 支持 WebP 等特殊格式图片处理 - 自动处理无扩展名图片 - 提供完整的图片处理工具链 - 一键式工作流 支持完整的 Markdown 语法 (代码块、表格、引用、列表等)。 自动生成封面、目录、页眉页脚。 使用场景: 技术文档、白皮书、教程、报告等需要专业排版的 Markdown 文档。 |
| user-invocable | true |
| metadata | {"short-description":"Markdown 转专业 PDF 白皮书（苹果设计风格）","version":"2.0.0","category":"productivity"} |
将 Markdown 文档转换为专业的苹果设计风格 PDF 白皮书。
重大改进:
依赖变更:
# 旧版本 (v1.0)
pip3 install markdown2 weasyprint
brew install pango # 复杂
# 新版本 (v2.0)
pip3 install markdown pdfkit Pillow
brew install wkhtmltopdf # 简单
# 转换单个文件
python scripts/convert.py input.md
# 指定输出文件名
python scripts/convert.py input.md -o "我的白皮书.pdf"
# 自定义标题和作者
python scripts/convert.py input.md --title "技术白皮书" --author "花叔"
# 一键执行: 图片处理 + PDF 生成
python scripts/workflow.py input.md
# 跳过图片处理
python scripts/workflow.py input.md --skip-images
# 完整自定义
python scripts/workflow.py input.md \
--title "技术白皮书" \
--author "团队" \
-o "output.pdf"
# 步骤 1: 分析图片格式
python scripts/analyze_images.py
# 步骤 2: 转换 WebP 图片
python scripts/batch_convert_images.py
# 步骤 3: 更新 Markdown 引用
python scripts/update_markdown_refs.py
# 步骤 4: 生成 PDF
python scripts/convert.py input.md
你的 Markdown 文档应该遵循以下结构:
# 文档标题
## 1. 第一章
### 1.1 第一节
### 1.2 第二节
## 2. 第二章
### 2.1 第一节
关键规则:
## 1. 标题 (数字 + 点 + 空格 + 标题)### 1.1 标题 (数字.数字 + 空格 + 标题)将 Markdown 转换为 PDF,支持:
检测图片实际格式:
批量转换 WebP 为 PNG:
更新 Markdown 中的图片引用:
一键执行所有步骤:
pip3 install markdown pdfkit Pillow
# macOS
brew install wkhtmltopdf
# Linux
sudo apt-get install wkhtmltopdf
# 或下载二进制: https://wkhtmltopdf.org/downloads.html
A: 确保你的 Markdown 使用了正确的章节格式:
## 1. 标题 而不是 ## 标题### 1.1 标题 而不是 ### 标题A: 确保使用三个反引号包裹:
```python
def hello():
print("Hello")
```
A: 使用标准的 Markdown 表格语法:
| 列1 | 列2 |
|-----|-----|
| 值1 | 值2 |
A:
# macOS
brew install wkhtmltopdf
# Linux
sudo apt-get install wkhtmltopdf
# 或下载二进制
# https://wkhtmltopdf.org/downloads.html
A: 使用完整工作流:
python scripts/workflow.py input.md
它会自动处理所有图片问题。
A: 查看 UPGRADE.md 文档了解详细升级步骤。
如果需要自定义样式,可以修改 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'
.claude/skills/markdown-to-pdf/
├── SKILL.md # 本文件
├── README.md # 快速开始
├── EXAMPLES.md # 使用示例
├── UPGRADE.md # 升级指南
├── WORKFLOW.md # 工作流文档
└── scripts/
├── convert.py # 核心转换工具
├── analyze_images.py # 图片分析
├── batch_convert_images.py # 批量转换
├── update_markdown_refs.py # 引用更新
└── workflow.py # 完整工作流
本 Skill 使用: