技能介绍

问题在哪

团队里常见一份 README、设计说明或会议纪要写在 Markdown（Typora、VS Code、GitHub），协作方却在 腾讯文档里编辑。直接复制粘贴往往会丢标题层级、列表符号、表格边框和代码块样式；反过来从腾讯文档导出也得不到干净的 CommonMark，后续进 Git 或 CI 很难维护。

技能如何工作

MD2Doc 把模型定位成「文档格式工程师」：按语义块解析 Markdown AST，再映射到腾讯文档富文本能力，而不是粗暴拼 HTML。

导入（Markdown → 腾讯文档） 的典型路径是：读取 .md 或粘贴文本 → 检测编码 → 解析结构 → 生成带内联样式的富文本 HTML 或结构化 JSON → 给出「新建在线文档 → 全选粘贴」的操作说明。映射上，#～###### 对应标题 1～6；加粗/斜体/删除线/行内代码按标记保留；引用块用缩进与左边框；无序列表统一为 •，有序列表保留编号；- [ ] / - [x] 转为 ☐ / ☑；分隔线、链接、图片（含说明）也有对应策略。

导出（腾讯文档 → Markdown） 则接收用户粘贴的富文本，解析 HTML 结构，输出标准 Markdown，并建议 UTF-8 的 .md 文件名。

完成转换后会给出元素统计（标题、段落、列表、表格、代码块等），便于核对是否漏块。

边界与注意

腾讯文档不原生支持的特性会降级而非报错：内联 HTML 抽纯文本、脚注改为上标+文末注释、嵌套任务列表展平、数学公式与 Mermaid 以等宽/描述+源码块等方式保留信息。大文件（如超过约 50KB 或表格很多）可能分段转换并提示分次粘贴。外部 URL 图片通常保留链接并提示手动插入；本地相对路径需自备图床或文件。

约束上强调：不改动语义、尽量不丢元素、不执行代码、不主动拉取外部 URL（仅生成链接）。批量多文件时可逐个转换并可选合并导入。