doc-convert · Markdown 排版转换

Markdown 排版转换 skill:把 Markdown 文稿排版并转换为 HTML(干净可读排版 + CJK 字体)、可打印 PDF(A4)、长图 PNG(适合发朋友圈/存档)。走统一转换脚本,一句命令出三种格式。
只处理 Markdown:DOCX/PPT 不在范围内,大纲转脑图用 mindmap,公众号专属排版用 skill-wechat-publisher,海报见 card-*/poster-hero。产物统一输出到 outputs/主题名/。
调用示例:在聊天框中说"把这篇 Markdown 转成 PDF 和长图"。
产品详解
定位
doc-convert 是 Markdown 的排版与多格式转换器:一输入、三输出(HTML / PDF / 长图 PNG)。它只处理 Markdown。
核心能力
- 三格式输出:HTML(干净可读排版 + CJK 字体)/ PDF(A4 可打印,适合存档/发送)/ 长图 PNG(适合发不支持 MD 的平台、朋友圈存档)。
- 脚本一键转换:
scripts/doc_convert.py convert -i 输入.md -o outputs/主题名/x.{html,pdf,png}。 - 排版参数:长图宽度
--width按平台调(朋友圈/小红书约 750–1080);--page-width控制 HTML/PDF 版心。 - 环境前置:MD→HTML 需
pip install markdown;MD→PDF/PNG 需 playwright + chromium。
工作流程
- 接收 Markdown 文件(支持标题、列表、表格、代码块、引用、图片)
- 执行转换脚本,指定输出格式
- 产物落盘到
outputs/主题名/
输入与输出
| 输入 | 说明 |
|---|---|
| Markdown 文件 | 必填,支持标题、列表、表格、代码块、引用、图片;图片路径须可访问 |
输出:HTML / PDF / 长图 PNG,统一进 outputs/主题名/。
与相邻 skill 的区别
| skill | 分工 |
|---|---|
| doc-convert(本) | Markdown 通用排版转换(HTML/PDF/长图) |
| mindmap | 层级大纲转思维导图 |
| skill-wechat-publisher | 公众号专属排版 |
| card-*/poster-hero | 卡片/海报设计 |
适用场景
- 文章转长图发朋友圈/小红书
- 文稿导出 PDF 存档或发送
- Markdown 转干净 HTML 网页排版
使用前准备
- 准备 Markdown 文件;图片使用可访问的相对/绝对路径。
- 需要 DOCX/PPT/富交互排版时本 skill 不覆盖。
doc-convert 隶属于 Aiglade Skill 库。在 Aiglade 聊天框中用自然语言描述需求即可调用。