# Send Md2pdf WeasyPrint to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "md2pdf-weasyprint",
    "name": "Md2pdf WeasyPrint",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/franklu0819-lang/md2pdf-weasyprint",
    "canonicalUrl": "https://clawhub.ai/franklu0819-lang/md2pdf-weasyprint",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/md2pdf-weasyprint",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=md2pdf-weasyprint",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/convert-weasyprint.py",
      "scripts/convert-weasyprint.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/md2pdf-weasyprint"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/md2pdf-weasyprint",
    "downloadUrl": "https://openagent3.xyz/downloads/md2pdf-weasyprint",
    "agentUrl": "https://openagent3.xyz/skills/md2pdf-weasyprint/agent",
    "manifestUrl": "https://openagent3.xyz/skills/md2pdf-weasyprint/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/md2pdf-weasyprint/agent.md"
  }
}
```
## Documentation

### Markdown 转 PDF 技能

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

### ⭐ 推荐方案：WeasyPrint

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

### 快速开始

# 转换 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 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 scripts/convert.sh input.md output.pdf

### 方法 3：简化 HTML

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

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

### convert-weasyprint.sh ⭐

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

特性：

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

用法：

bash scripts/convert-weasyprint.sh <输入.md> [输出.pdf]

参数：

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

示例：

# 转换单个文件
bash scripts/convert-weasyprint.sh README.md

# 指定输出路径
bash scripts/convert-weasyprint.sh README.md /tmp/readup.pdf

# 批量转换
for md in *.md; do
    bash scripts/convert-weasyprint.sh "$md"
done

### convert-weasyprint.py

Python 转换脚本，被 convert-weasyprint.sh 调用，也可直接使用。

用法：

python3 scripts/convert-weasyprint.py <输入.md> [输出.pdf]

功能：

Markdown 解析（支持表格、代码块、列表）
HTML 生成
CSS 样式应用
PDF 输出

### convert.sh

Pandoc 传统方案（需要 LaTeX）。

用法：

bash scripts/convert.sh <输入.md> [输出.pdf]

前置要求：

pandoc
xelatex (LaTeX)
中文字体

### convert-simple.sh

简化版，生成 HTML 供浏览器打印。

用法：

bash scripts/convert-simple.sh <输入.md> [输出.pdf]

### WeasyPrint 方案

使用 Python 的 WeasyPrint 库进行转换：

# 1. Markdown → HTML
html_content = markdown.markdown(
    md_content,
    extensions=['tables', 'fenced_code', 'nl2br', 'sane_lists']
)

# 2. HTML + CSS → PDF
HTML(string=html_content).write_pdf(
    output_file,
    stylesheets=[CSS(string='...')]
)

CSS 样式特性：

中文字体：Noto Sans CJK SC
代码块：深色主题（#2c3e50 背景）
表格：蓝色表头 + 斑马纹
引用块：左边框 + 浅灰背景
响应式设计

### Pandoc 方案

使用 pandoc 的 LaTeX 引擎：

pandoc input.md -o output.pdf \\
  --pdf-engine=xelatex \\
  -V CJKmainfont="Noto Sans CJK SC" \\
  -V geometry:margin=2cm

### 支持的 Markdown 特性

✅ 标题（h1-h6）
✅ 段落和换行
✅ 列表（有序、无序）
✅ 代码块（支持语法高亮）
✅ 表格
✅ 链接和图片
✅ 引用块
✅ 水平线
✅ 粗体和斜体
✅ 自动链接

### Python 依赖

# 自动安装（首次运行时）
python3 -m pip install markdown weasyprint

### 中文字体

# 自动安装（首次运行时）
yum install -y google-noto-sans-cjk-fonts

### Pandoc（可选）

# CentOS/RHEL
yum install -y pandoc

# Ubuntu/Debian
apt-get install -y pandoc

### 问题 1：中文显示为方块或乱码

解决方案（WeasyPrint）：

# 安装中文字体
yum install -y google-noto-sans-cjk-fonts

# 验证字体
fc-list | grep "Noto Sans CJK"

解决方案（Pandoc）：

# 安装中文字体
yum install -y google-noto-sans-cjk-sc-fonts

# 使用 xelatex
pandoc input.md -o output.pdf --pdf-engine=xelatex -V CJKmainfont="Noto Sans CJK SC"

### 问题 2：Python 模块未找到

解决方案：

# 安装 Python 依赖
python3 -m pip install markdown weasyprint

# 验证安装
python3 -c "import markdown, weasyprint; print('OK')"

### 问题 3：字体渲染问题

解决方案：

# 清除字体缓存
fc-cache -fv

# 重新安装字体
yum reinstall -y google-noto-sans-cjk-fonts

### 问题 4：PDF 文件过大

原因： WeasyPrint 会嵌入完整字体

解决方案：

使用子集化字体（需要额外工具）
或使用在线字体（需要网络连接）
或接受文件大小（通常 500KB-2MB）

### 示例 1：基本转换

# 创建测试文件
cat > test.md << 'EOF'
# 测试文档

这是中文测试文档。

## 功能列表

- 支持 Markdown
- 代码高亮
- 表格样式

| 列1 | 列2 |
|-----|-----|
| A   | B   |

\\\`\\\`\\\`python
print("Hello, World!")
\\\`\\\`\\\`
EOF

# 转换为 PDF
bash scripts/convert-weasyprint.sh test.md

### 示例 2：批量转换

# 转换目录下所有 Markdown 文件
for file in *.md; do
    echo "转换: $file"
    bash scripts/convert-weasyprint.sh "$file"
done

### 示例 3：集成到脚本

#!/bin/bash
# 自动转换脚本

INPUT_DIR="/path/to/markdown/files"
OUTPUT_DIR="/path/to/pdf/output"

mkdir -p "$OUTPUT_DIR"

for md in "$INPUT_DIR"/*.md; do
    output="$OUTPUT_DIR/$(basename "$md" .md).pdf"
    bash /root/.openclaw/workspace/skills/md2pdf/scripts/convert-weasyprint.sh "$md" "$output"
done

### 修改 CSS 样式

编辑 scripts/convert-weasyprint.py 中的 CSS 字符串：

css = CSS(string='''
    /* 修改字体大小 */
    body {
        font-size: 12pt;  /* 默认 11pt */
    }

    /* 修改主色调 */
    h1, h2 {
        color: #e74c3c;  /* 改为红色 */
    }

    /* 修改代码块背景 */
    pre {
        background-color: #34495e;  /* 深色主题 */
    }
''')

### 自定义模板

修改 HTML 模板以添加页眉、页脚等：

full_html = f"""
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>{title}</title>
</head>
<body>
    <header>
        <h1>我的公司</h1>
    </header>
    {html_content}
    <footer>
        <p>机密文档</p>
    </footer>
</body>
</html>
"""

### 加速转换

使用缓存： 保存字体缓存
批量处理： 合并多个 Markdown 为一个 PDF
并行处理： 使用 GNU parallel

# 并行转换
ls *.md | parallel -j 4 bash scripts/convert-weasyprint.sh {}

### 相关技能

feishu-doc: 飞书文档操作
feishu-drive: 飞书云文件管理
md2pdf: Markdown 转 PDF（本技能）

### 常见问题

Q: WeasyPrint 和 Pandoc 哪个更好？

A: 推荐使用 WeasyPrint：

✅ 完美中文支持（无需配置）
✅ 自动安装依赖
✅ 轻量级（无需 LaTeX）
✅ 跨平台

Pandoc 适合已有 LaTeX 环境的场景。

Q: 可以在 Docker 中使用吗？

A: 可以，但需要安装字体：

FROM python:3.11
RUN pip install markdown weasyprint
RUN apt-get update && apt-get install -y fonts-noto-cjk

Q: 支持数学公式吗？

A: WeasyPrint 不直接支持，可以：

使用 MathJax（需要 JavaScript）
或使用 Pandoc + LaTeX 方案

### v2.0 (2026-02-16)

✨ 新增 WeasyPrint 方案（推荐）
✨ 完美中文支持
✨ 自动依赖安装
✨ 专业 CSS 样式
✨ 代码高亮深色主题
🐛 修复中文乱码问题

### v1.0

⚠️ 初始版本（Pandoc 方案）
⚠️ 需要手动安装 LaTeX
⚠️ 中文支持有限

### 许可证

MIT License

作者: 小美 ⭐
最后更新: 2026-02-16
推荐方案: WeasyPrint (convert-weasyprint.sh)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: franklu0819-lang
- Version: 2.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/md2pdf-weasyprint)
- [Send to Agent page](https://openagent3.xyz/skills/md2pdf-weasyprint/agent)
- [JSON manifest](https://openagent3.xyz/skills/md2pdf-weasyprint/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/md2pdf-weasyprint/agent.md)
- [Download page](https://openagent3.xyz/downloads/md2pdf-weasyprint)