Markdown 公文

在 VS Code 里编辑和导出党政公文。Markdown 所见即所得编辑，一键导出符合 GB/T 9704 的 Word 文档。

文件始终是标准 Markdown，插件只做视觉渲染，不改动内容。

For non-Chinese users: This extension is designed for formatting Chinese government documents (党政公文) according to the national standard GB/T 9704-2012. If you do not work with Simplified Chinese government documents, this extension is unlikely to be useful for you. This project is a fork of SeardnaSchmid/markdown-inline-editor-vscode — a WYSIWYG inline Markdown editor for VS Code — with added Chinese government document font styling and one-click DOCX export.

项目背景： 本项目基于 SeardnaSchmid/markdown-inline-editor-vscode 二次开发，在原版出色的 Markdown 行内编辑框架基础上，新增了 GB/T 9704 公文字体风格和一键导出 DOCX 功能。

Background: This project is a derivative work based on SeardnaSchmid/markdown-inline-editor-vscode. It extends the original inline Markdown editing framework with Chinese government document (GB/T 9704) font styling and one-click DOCX export.

两件事

编辑 — 打开 .md 文件，标题、加粗、链接、图片、表格、公式、Mermaid 图表全部在编辑区行内渲染，不用开预览面板。字体按 GB/T 9704 公文规范自动匹配：一级标题用黑体，二级用楷体，正文用仿宋。

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

演示

光标移到某行，语法标记淡入；点击或选中则完全显示原始 Markdown。

安装

1. 在 VS Code 扩展市场搜索 "Markdown 公文"，或直接安装 .vsix
2. 打开任意 .md 文件，插件自动激活
3. 系统要求：VS Code 1.100+（也支持 Cursor）

注意：本插件与原版 Markdown Inline Editor 不能同时安装。如果已装原版，请先卸载。

导出 DOCX

编辑器右上角有个 Word 文档图标，点击即导出。也可以用命令面板：

• 导出公文 DOCX — 弹出保存对话框
• 快速导出公文 DOCX — 直接保存到 .md 文件同目录

排版规格

标题字体

**加粗** 导出为楷体（不加粗），公文用字体区分强调，不用粗细区分。

方正小标宋为 GB/T 9704 标准指定的公文标题字体。如系统未安装该字体，Word 导出时会自动回退到宋体，不影响使用。

详细规格见 docs/features/docx-export.md。

安装后配置

安装插件后，建议为 Markdown 文件单独设置字号和行高，使编辑体验更贴近公文排版效果。

打开 VS Code 设置（Ctrl+, / Cmd+,），点击右上角的 {} 图标打开 settings.json，加入以下配置：

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

这段配置只影响 .md 文件，不会改变代码文件的显示。

字体自定义

如果需要更精细地控制编辑器中的字体显示，可以在 settings.json 中配置 markdownGongwen.fonts.*：

{
  "markdownGongwen.fonts.heading1.fontFamily": "Arial, SimHei, Heiti SC, sans-serif",
  "markdownGongwen.fonts.heading1.fontWeight": "normal",
  "markdownGongwen.fonts.heading1.fontSize": "137%",
  "markdownGongwen.fonts.heading2.fontFamily": "Arial, KaiTi, STKaiti, serif",
  "markdownGongwen.fonts.heading2.fontWeight": "normal",
  "markdownGongwen.fonts.heading2.fontSize": "100%",
  "markdownGongwen.fonts.heading3.fontFamily": "\"Times New Roman\", FangSong, STFangsong, serif",
  "markdownGongwen.fonts.heading3.fontWeight": "bold",
  "markdownGongwen.fonts.heading3.fontSize": "100%",
  "markdownGongwen.fonts.body.fontFamily": "\"Times New Roman\", FangSong, STFangsong, serif",
  "markdownGongwen.fonts.body.fontWeight": "normal"
}

字体必须安装在操作系统上才能生效。macOS 用户如果没有 SimHei / KaiTi / FangSong，系统会自动使用 Heiti SC / STKaiti / STFangsong 替代。设置为空值即使用编辑器默认字体。

三态语法遮蔽

编辑时 Markdown 标记符号自动隐藏，光标靠近时淡入，点击后完全显示。三个状态：

• 渲染态（默认）：语法标记隐藏，只看到格式化内容
• 幽灵态（光标所在行）：标记半透明淡入，提供编辑提示
• 原始态（点击/选中）：完整显示原始 Markdown

表格比较特殊——光标进入表格任意一行，整个表格切换为原始 Markdown。

支持的功能

文本格式

• [x] 粗体（**文本**）、斜体（*文本*）、粗斜体（***文本***）
• [x] 删除线（~~文本~~）、行内代码（`代码`）

文档结构

• [x] 标题（# 到 ######）——公文字体风格
• [x] 链接、图片、引用、分割线、GFM 表格
• [x] GitHub @提及和 #引用

列表

• [x] 无序列表、任务列表（可点击切换）

代码与扩展

• [x] 代码块、YAML 前置元数据、Emoji 短代码
• [x] Mermaid 图表——行内渲染
• [x] LaTeX 数学公式（$...$、$$...$$）——行内渲染

配置项

打开设置搜索 "Markdown Gongwen"：

字体

公文导出（DOCX）中用到的字体：

以上字体为 GB/T 9704 标准要求。如系统未安装，Word 会自动使用回退字体替代（如宋体、Heiti SC 等），不影响文档生成。

开发者

git clone https://github.com/sinnohzeng/markdown-gongwen-vscode.git
cd markdown-gongwen-vscode
npm install
npm test

按 F5 启动 Extension Development Host。

src/
├── extension.ts          入口
├── config.ts             配置
├── parser.ts             Markdown 解析（remark）
├── decorations.ts        装饰类型
├── decorator.ts          装饰协调
├── export/               DOCX 导出模块
├── math/                 LaTeX 渲染
├── mermaid/              Mermaid 渲染
└── */__tests__/          测试

已知限制

• GFM 表格暂不支持多行单元格
• 行间距需手动设置 editor.lineHeight
• 超过 1MB 的文件解析可能较慢
• Mermaid 图表和 LaTeX 公式导出为纯文本（DOCX 暂不支持渲染）

许可证

MIT License——详见 LICENSE.txt

致谢

本项目基于 SeardnaSchmid 的 markdown-inline-editor-vscode 开发。感谢原作者建立了出色的 Markdown 行内编辑框架。

灵感来源：

• markdown-inline-preview-vscode
• Markless
• Typora
• Obsidian

原版贡献者：@patrick-yip、@bircni、@ssebs、@IrishBruse