Markdown to PDF Skill

Core Features

1. Professional Typesetting: Book-level typesetting quality, automatically handles page breaks and widows/orphans
2. Apple Design: SF font system, modern and concise style, professional color scheme
3. Complete Table of Contents: Automatically extracts chapter structure, two-column layout, clickable jumps
4. Full Markdown Support: Correctly renders code blocks, tables, blockquotes, lists, etc.

Usage

Basic Usage

# 转换单个文件
python scripts/convert.py input.md

# 指定输出文件名
python scripts/convert.py input.md -o "我的白皮书.pdf"

# 自定义标题和作者
python scripts/convert.py input.md --title "技术白皮书" --author "花叔"

Markdown Document Requirements

# 文档标题

## 1. 第一章
### 1.1 第一节
### 1.2 第二节

## 2. 第二章
### 2.1 第一节

• Main chapters:

  ## 1. Title

  (number + dot + space + title)
• Sub-chapters:

  ### 1.1 Title

  (number.number + space + title)
• This ensures correct table of contents extraction

Design Features

Cover Design

• Light gray gradient background
• Large title: 64pt, concise and modern
• Subtitle and meta information

Table of Contents Design

• Two-column layout, single-page display
• Main chapters in bold, sub-chapters indented
• Clickable jumps to corresponding chapters

Body Typesetting

• SF font family (Apple design language)
• Line height 1.7, comfortable reading
• Automatic page breaks for chapters
• Widow/orphan control

Code Blocks

• Light gray background + thin border
• 8px rounded corners
• SF Mono monospaced font
• Automatically avoids page breaks

Tables

• Clear grid lines
• Light gray header
• Automatically retains header (for long tables with page breaks)

Configuration Options

scripts/convert.py

# 主色调
PRIMARY_COLOR = '#06c'      # 苹果蓝
TEXT_COLOR = '#1d1d1f'      # 主文本黑色
GRAY_COLOR = '#86868b'      # 浅灰色

# 字体大小
COVER_TITLE_SIZE = '64pt'
H2_SIZE = '22pt'
H3_SIZE = '17pt'
BODY_SIZE = '11pt'

Frequently Asked Questions

Q: Why is the table of contents empty?

• ## 1. Title

  instead of

  ## Title

• ### 1.1 Title

  instead of

  ### Title

Q: Why are code blocks not displaying correctly?

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

Q: Why is the table format messed up?

| Column1 | Column2 |
|-----|-----|
| Value1 | Value2 |

Q: How to modify fonts?

scripts/convert.py

font-family

Q: Why is the generated PDF too large?

Dependency Installation

pip3 install markdown2 weasyprint

brew install pango
pip3 install weasyprint

Examples

Generate Technical Document

python scripts/convert.py tech-guide.md -o "技术指南.pdf"

Generate Whitepaper

python scripts/convert.py whitepaper.md --title "产品白皮书" --author "团队"

Script Explanation

• scripts/convert.py

  - Main conversion script

• scripts/styles.css

  - CSS style definitions (embedded in the script)

• templates/cover.html

  - Cover template (embedded in the script)

Technical Implementation

• markdown2: Markdown parsing (supports extended syntax)
• WeasyPrint: HTML to PDF conversion (supports CSS3)
• Apple Design System: SF fonts, professional color scheme, modern typesetting

Changelog

v1.0 (2025-12-24)

• Initial version
• Supports full Markdown syntax
• Apple design style
• Automatic table of contents generation
• Book-level typesetting quality