Agent Skills
返回列表
Markdown 文档转换器

Markdown 文档转换器

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md ，安装 @user_15292d5a/yjkj-md-converter

技能介绍

要解决什么问题

Markdown 写起来很顺手，但交付场景往往不止 .md 一种形态：给非技术同事要 Word，给正式场合要 PDF，给网页嵌入要 HTML。手工复制粘贴一次，表格和代码块的排版基本就毁了。这个技能做的事很单纯：读入一个 .md 文件，按你指定的格式产出成品文件。

核心能力与工作方式

  • HTML：生成响应式页面，内嵌 CSS 卡片式布局，桌面端和移动端均可查看，无外部依赖。
  • DOCX：产出带样式的 Word 文档，标题、表格（表头着色 + 斑马纹）、列表、代码块都有基本格式化。
  • PDF：基于 reportlab 生成，中文支持依赖系统字体（macOS 为 PingFang，Windows 为 SimHei）。
  • 批量：convert_all.py 可一次跑完三种格式。

工作流分四步：自动探测 Python 运行时（优先 python3，Windows 上没有则用 python）、按需补齐依赖、根据用户表述选择对应脚本执行、检查产物并将文件发回。每个脚本可选的第二个参数用于指定输出路径。

适用边界与注意点

  • 引用块（Blockquote）仅在 HTML 中保留，DOCX 和 PDF 会丢失。
  • PDF 的中文渲染依赖系统字体，字体缺失时回退 Helvetica，中文显示为方块。
  • 含特殊字符（引号、破折号）的中文文本，建议确认输入文件为 UTF-8 编码，或改用 ASCII 等价写法。

使用场景

  • 把 Markdown 格式的技术文档转成 Word，交给不使用 Markdown 的同事评审。
  • 将写在 Markdown 里的长文转成 PDF，用于线下打印或正式存档。
  • 把 Markdown 笔记转成带响应式样式的 HTML 页面，直接在浏览器里查看。
  • 一次性把一份 Markdown 文档批量转成 Word、PDF 和 HTML 三种格式交付。

适合人员

  • 技术博客作者，需要把 Markdown 文章转成 PDF 或 HTML 进行多渠道发布。
  • 产品经理，需要把 Markdown 格式的需求文档转成 Word 发给业务和测试团队。
  • 学生，需要把 Markdown 格式的课程笔记或作业转成 Word 提交给老师。
  • 独立开发者，需要把 Markdown 格式的 README 转成 PDF 作为项目说明文档。