Markdown 办公助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/md-to-office
技能介绍
先说清楚它解决什么问题
工程文档大多以 Markdown 形式沉淀在仓库里:README、接口说明、设计笔记、周报。可到了交付环节,对方要的是 Word 合同、汇报要用 PPT、归档要 PDF。手动复制粘贴一次,格式就散一次:标题层级错乱、表格错位、图片跑偏。反复调样式的时间,往往比写文档本身还长。
这个技能把这条转换链路交给 Pandoc,让同一份 Markdown 源文件按目标格式重新渲染,而不是逐段手工搬运。
它是怎么工作的
核心依赖是 Pandoc,一个通用文档转换器。技能接收三类输入:Markdown 文本或文件路径、目标格式标识、可选的样式模板。底层调用就是一条命令,例如 pandoc in.md -o out.docx。
支持的转换方向包括:
- Markdown → Word(
.docx) - Markdown → PowerPoint(
.pptx) - Markdown → PDF
- Markdown → HTML / LaTeX / EPUB
几个值得留意的能力:
模板注入。用 --reference-doc 指定参考文档,字体、页边距、标题样式直接沿用模板,适合需要统一品牌的团队。
目录与元数据。--toc 生成目录;在文件头部写 YAML frontmatter,标题、作者、日期会写进文档属性。
PDF 两条路径。走 LaTeX 质量最好,但需要本地装 TeX 环境;走 HTML 配 wkhtmltopdf 更轻,适合简单排版。
适用边界
- 复杂 Word 排版(文本框、艺术字、多栏嵌套)不能保证完美还原
- PDF 转换必须预装 LaTeX 或 wkhtmltopdf,否则会失败
- PPT 不支持动画与切换效果,转出来的就是静态页面
- 复杂表格和图片定位常常需要手工微调,建议先转小节验证再批量跑
- 图片用相对路径,并显式指定尺寸更稳
使用场景
- 把仓库里的 README.md 转成带目录的 Word 文档发给外部合作方
- 将 Markdown 会议纪要转成 PPT 用于评审汇报
- 用公司模板把技术方案转成 PDF 归档
- 批量把接口文档转成 HTML 便于内部查阅
适合人员
- 需要把 Git 仓库里的 Markdown 文档转成 Word 交付的后端工程师
- 要定期把技术笔记转成汇报 PPT 的研发团队负责人
- 负责统一对外文档样式的技术文档工程师
- 想把同一份 Markdown 源发布到多种格式的内容维护者