Markdown Gongwen 公文

用 Markdown 写党政公文，一键导出符合 GB/T 9704-2012 的 Word 文档。

写公文的痛苦从来不在内容，而在排版：字体要在方正小标宋、黑体、楷体、仿宋之间切换，行距要固定 28 磅，页码要"—1—"还分奇偶页。这个插件把这些全部固化成代码——你只管用 Markdown 写，标题层级、字体搭配、版面规格、页码格式，导出瞬间全部按国标就位。

For non-Chinese users: This extension formats Chinese government documents (党政公文) per national standard GB/T 9704-2012. If you don't work with Simplified Chinese government documents, it is unlikely to be useful for you.

两件事

编辑 — 打开 .md 文件，标题、加粗、链接、图片、表格、公式、Mermaid 图表全部在编辑区行内渲染，不用开预览面板。语法标记自动隐藏，光标靠近时淡入，点击后完全显示。文件始终是标准 Markdown，插件只做视觉渲染，不改动内容。

导出 — 点一下编辑器右上角的 Word 图标，当前文档直接导出为 .docx。页面尺寸、边距、字体、字号、行距、页码全部按 GB/T 9704 来，拿到手就能用。

排版规格

导出的每一个数值都溯源到 GB/T 9704-2012 条文（详见 docs/features/docx-export.md）：

标题字体

公文用字体区分强调，不用粗细区分：**加粗** 导出为楷体（不加粗），> 引用导出为楷体正文。导出使用系统字体；方正小标宋为商业字体不随包分发，未安装时 Word 自动回退宋体，不影响使用。

安装与兼容

在扩展市场搜索 "Markdown Gongwen 公文" 安装：

• VS Code（1.100+）：VS Code Marketplace
• Cursor / Windsurf / Trae / VSCodium：Open VSX（这些编辑器的扩展市场直接可搜）

引擎门槛特意压在 1.100，Cursor（1.105 内核）、Trae（1.104 内核）等基于旧内核的编辑器都能装。

本插件由 Markdown Inline Editor 二次开发而来，两者不能同时启用（会重复渲染）。

导出 DOCX

编辑器右上角的 Word 图标一键导出。也可以用命令面板：

• 导出公文 DOCX — 弹出保存对话框，记住上次目录
• 快速导出当前文件为 DOCX — 直接保存到 .md 同目录

导出过程带进度条、可取消；完成后通知里可直接"打开文件"或"在文件管理器中显示"；出错时"查看日志"可看完整记录。本地图片自动等比缩放到版心宽度。

编辑体验建议

为 Markdown 文件单独设置字号行高，编辑观感更贴近公文（Cmd/Ctrl+, 打开设置，进 settings.json）：

{
  "[markdown]": {
    "editor.fontSize": 22,
    "editor.lineHeight": 1.8,
    "editor.wordWrap": "bounded",
    "editor.wordWrapColumn": 56,
    "editor.minimap.enabled": false,
    "editor.quickSuggestions": { "comments": "off", "strings": "off", "other": "off" }
  }
}

只影响 .md 文件，不改代码文件显示。

支持的功能

• 文本：粗体、斜体、删除线、行内代码
• 结构：六级标题（公文字体风格）、链接、图片、引用、分割线、GFM 表格
• 列表：无序列表、有序列表（自动连续编号，源文件不动）、任务列表（可点击切换）
• 扩展：代码块、YAML frontmatter、Emoji 短代码、GitHub @提及 与 #引用
• 图形：Mermaid 图表行内渲染、LaTeX 公式（$...$、$$...$$）行内渲染
• 题注：表N 表题（表上方段落）、图N 图题（图片 alt）自动按国标排版，导出与图表同页

配置项

设置里搜索 "Markdown Gongwen"。以下配置只影响编辑视图的渲染观感；导出 DOCX 的版式始终按 GB/T 9704 固定，不受任何配置影响：

常见问题

活动栏里为什么有个"Markdown Gongwen"图标（Mermaid 渲染视图）、导出字体、大文件性能等，见 docs/FAQ.md。

开发者

git clone https://github.com/sinnohzeng/markdown-gongwen-vscode.git
cd markdown-gongwen-vscode
npm install   # postinstall 自动准备 Mermaid 资源
npm test

按 F5 启动 Extension Development Host。

src/
├── extension.ts          入口
├── parser.ts             Markdown 解析（remark）
├── decorator.ts          装饰协调（三态可见性）
├── export/               DOCX 导出（mdast → GB/T 9704 OOXML）
├── math/                 LaTeX 行内渲染
├── mermaid/              Mermaid 行内渲染（懒加载 webview）
└── */__tests__/          测试

已知限制

• GFM 表格暂不支持多行单元格
• Mermaid 图表和 LaTeX 公式导出 DOCX 时为占位文本/源码（导出结束会通知未完整呈现的内容清单；路线图上有位图方案）
• 图表题注自动识别仅限以 图N / 表N 开头的写法，其余按普通正文输出
• 超过 1MB 的文件解析可能较慢
• 行间距需手动设置 editor.lineHeight（VS Code 不允许插件按语言改行高）

许可证与致谢

MIT License，详见 LICENSE.txt。

行内渲染框架基于 SeardnaSchmid/markdown-inline-editor-vscode 二次开发，公文排版与 DOCX 导出为本仓库新增。感谢原作者与贡献者 @patrick-yip、@bircni、@ssebs、@IrishBruse。