md2pdf

# Markdown 转 PDF 技能

将 Markdown 文件转换为精美的 PDF 文档，支持中文、代码高亮、自定义样式。

## ⭐ 推荐方案：WeasyPrint

**完美支持中文，无需 LaTeX，自动处理依赖！**

### 快速开始

```bash
# 转换 Markdown 为 PDF（推荐）
bash /root/.openclaw/workspace/skills/md2pdf/scripts/convert-weasyprint.sh input.md

# 指定输出文件名
bash /root/.openclaw/workspace/skills/md2pdf/scripts/convert-weasyprint.sh input.md output.pdf
```

### 优点

- ✅ **完美中文支持**（使用 Noto Sans CJK 字体）
- ✅ **自动安装依赖**（首次运行时自动安装）
- ✅ **专业排版样式**（代码高亮、表格美化）
- ✅ **轻量级**（无需 LaTeX，仅 Python）
- ✅ **跨平台**（支持 Linux、macOS、Windows）

## 功能特性

- ✅ Markdown 转 PDF
- ✅ **完美中文支持**（无乱码）
- ✅ 代码语法高亮（深色主题）
- ✅ 专业表格样式（斑马纹、圆角）
- ✅ 多级标题样式
- ✅ 引用块美化
- ✅ 列表、链接、图片支持
- ✅ 自定义 CSS 样式

## 使用方法

### 方法 1：WeasyPrint（推荐）⭐

**适合场景：** 需要完美中文显示、专业排版

```bash
# 使用 Bash 脚本（自动处理依赖）
bash scripts/convert-weasyprint.sh document.md

# 指定输出文件
bash scripts/convert-weasyprint.sh document.md output.pdf

# 直接使用 Python 脚本
python3 scripts/convert-weasyprint.py input.md output.pdf
```

### 方法 2：Pandoc（备选）

**适合场景：** 已安装 LaTeX 环境

```bash
bash scripts/convert.sh input.md output.pdf
```

### 方法 3：简化 HTML

**适合场景：** 需要在浏览器中打印

```bash
bash scripts/convert-simple.sh input.md output.pdf
```

## 脚本说明

### convert-weasyprint.sh ⭐

**推荐使用** - WeasyPrint 方案，完美支持中文。

**特性：**
- 自动检测并安装 Python 依赖（markdown、weasyprint）
- 自动检测并安装中文字体（google-noto-sans-cjk-fonts）
- 专业的 CSS 样式（代码高亮、表格美化）
- 完整的错误处理

**用法：**
```bash
bash scripts/convert-weasyprint.sh <输入.md> [输出.pdf]
```

**参数：**
- `输入.md` (必需): Markdown 文件路径
- `输出.pdf` (可选): PDF 输出路径（默认：输入文件名.pdf）

**示例：**
```bash
# 转换单个文件
bash scripts/convert-weasyprint.sh README.md

# 指定输出...

# Markdown to PDF 技能

将 Markdown 文件转换为精美的 PDF 文档，完美支持中文、代码高亮、自定义样式。

## 特性

- ✅ **完美中文支持**（使用 Noto Sans CJK 字体）
- ✅ **自动安装依赖**（首次运行时自动安装）
- ✅ **专业排版样式**（代码高亮、表格美化）
- ✅ **轻量级**（无需 LaTeX，仅 Python）
- ✅ **跨平台**（支持 Linux、macOS、Windows）

## 快速开始

```bash
# 转换 Markdown 为 PDF
bash /root/.openclaw/workspace/skills/md2pdf/scripts/convert-weasyprint.sh input.md

# 指定输出文件名
bash /root/.openclaw/workspace/skills/md2pdf/scripts/convert-weasyprint.sh input.md output.pdf
```

## 依赖

- Python 3.x
- markdown
- weasyprint

依赖会在首次运行时自动安装。

## 作者

franklu0819-lang

## 许可证

MIT