Markdown Auto Space

在保存或格式化时，自动为 Markdown 中的中英文之间添加空格。

VS Code Marketplace

概述

中文与英文、数字混排时，在两者之间增加空格可提升可读性。本扩展在 VS Code 中针对 Markdown 文件，在保存或执行「格式化文档」时自动应用一套可配置的规则，对中英文、数字、链接、行内代码、斜杠等之间插入或规范化空格。

处理时会保护以下内容不被破坏，仅在其与中文的边界加空格：

• Markdown 链接：[文本](https://github.com/SWHL/markdown-auto-space/blob/HEAD/url)
• 图片：![alt](https://github.com/SWHL/markdown-auto-space/raw/HEAD/url)（图片 URL 内的斜杠等不参与空格规则）
• 粗体：**文本**
• 独立 URL（如 https://...）
• 行内代码：反引号包裹内容整体保护（支持单/多反引号定界），内部任意内容不参与空格规则
• 引号内容：双引号 "..."、单引号 '...' 内的内容一律不参与空格规则
• HTML 标签

以下代码中内容一律不处理：围栏代码块（```）、YAML front matter（---）内的行整体跳过；缩进代码块（行首 4 空格或 1 tab）的整行跳过；行内代码（反引号内）已在上面保护。

安装

在 VS Code 扩展市场搜索 Markdown Auto Space，或运行：

code --install-extension SWHL.markdown-auto-space

配置

本扩展仅处理 Markdown 文件（语言 ID 为 markdown），不处理 txt 等其他类型。

规则说明与示例

以下规则均可在 markdownAutoSpace.rules 中单独开启或关闭，默认全部为 true。格式示例为：输入 → 输出。

chineseAlnum — 中文与英文/数字之间加空格

在中文与英文字母、数字之间插入空格。

配置示例：

{
  "markdownAutoSpace.rules": {
    "chineseAlnum": true
  }
}

chineseBacktick — 中文与行内代码（反引号）之间加空格

在中文与 行内代码 之间插入空格。

| 输入 | 输出 | | --------------- | ----------------- | | 使用\rapidocr库|使用 `rapidocr 库| |`code块测试 |`code 块测试 | |测试`code块 |测试 `code 块` |

配置示例：

{
  "markdownAutoSpace.rules": {
    "chineseBacktick": true
  }
}

chineseLinkUrl — 中文与链接/URL 之间加空格

在中文与 Markdown 链接、裸 URL 之间插入空格；链接或 URL 本身会被保护，仅在其与中文的边界加空格。链接文本内的中英文仍按 chineseAlnum 处理。

配置示例：

{
  "markdownAutoSpace.rules": {
    "chineseLinkUrl": true
  }
}

dunhaoToComma — 英文/数字间的顿号改为逗号+空格

当中文顿号（、）出现在英文或数字之间时，替换为英文逗号加空格（, ）。

配置示例：

{
  "markdownAutoSpace.rules": {
    "dunhaoToComma": true
  }
}

slashSpace — 斜杠两侧加空格（仅当一侧为中文时）

仅在斜杠（/）一侧为中文时，在斜杠与两侧内容之间插入空格；两侧均为英文/数字时不加空格（如路径 path/to/file、分支名 release/v3.0、CPU/GPU）。

配置示例：

{
  "markdownAutoSpace.rules": {
    "slashSpace": true
  }
}

其他行为说明

• 粗体：粗体整体被保护，仅在与中文的边界加空格。 例：这是**重要内容**说明 → 这是 **重要内容** 说明。
• 图片语法：![](https://github.com/SWHL/markdown-auto-space/raw/HEAD/url) 或 ![alt](https://github.com/SWHL/markdown-auto-space/raw/HEAD/url) 整体被保护，URL 内的斜杠等不参与任何空格规则。 例：见图![](https://github.com/SWHL/markdown-auto-space/raw/HEAD/../../images/fig.jpg)说明 → 见图 ![](https://github.com/SWHL/markdown-auto-space/raw/HEAD/../../images/fig.jpg) 说明。
• 行内代码：反引号包裹的内容整体被保护，支持单/多反引号定界，内部任意内容不参与空格规则（如 `release/v3.0`、`**text**`、 a ` b / 中文English 保持原样）。
• 引号内容：双引号、单引号内的内容一律不处理（如 "EN中文"、'path/to' 保持原样）。
• 嵌套保护稳定恢复：对“保护内容里再含保护内容”的场景进行递归恢复，不会出现 __PROTECTED_x__ 泄漏到最终文本。
• 代码块：围栏代码块（```）内行、缩进代码块（行首 4 空格或 1 tab）的整行，均不参与处理。
• HTML 标签：标签整体被保护，仅在与中文的边界加空格。 例：</div>这是文本 → </div> 这是文本。
• 已有空格：已有空格的不会被重复插入。 例：已经有 空格 的文本 保持不变。
• 句号前：英文/数字后的中文句号前不会加空格。 例：RapidOCR。这是句号 保持不变。

关闭某条规则

在设置中将对应对规则设为 false 即可，例如只关闭斜杠规则：

{
  "markdownAutoSpace.rules": {
    "slashSpace": false
  }
}

查看运行日志

若扩展未按预期工作，可查看运行日志排查：

1. 菜单 查看 → 输出（或 Ctrl+Shift+U / Cmd+Shift+U）
2. 在输出面板右上角的下拉框中选择 Markdown Auto Space
3. 保存一个 .md 文件或执行命令「Markdown Auto Space」后，日志会记录是否激活、是否识别为 Markdown、是否产生编辑以及 applyEdit 是否成功

若日志里出现「跳过: 非 Markdown 文件」，请确认当前文件右下角语言模式为 Markdown（点击可切换）。

更新日志

更多版本与改动见 CHANGELOG。

许可证

MIT © SWHL