为什么需要它#

在 Obsidian 里写技术笔记，最容易被忽略的就是代码块的语言标签。很多人（包括我）写起来是这样：

1
```
2
print("Hello")
3
```

反引号后面空空的。后果是：代码块没有语法高亮、渲染成一片灰，复制代码块时格式也不友好——但真相往往是你只是忘了打那四个字母，并不是不想打。手动补又费劲，尤其是连续贴好几段不同语言的代码时。

这个插件就是干这件事的：自动识别代码块内容，把语言标签补上去。

它帮你做什么#

1
```          →   ``` python
2
def greet(name):
3
    print(f"hi, {name}")
4
```              ```

安全设计：它不会搞乱你的笔记#

这是我最看重的一点，也是它敢自动改文件的基础：

1. 绝不碰已有标签：已经写了 ```python 的块，动都不会动。
2. 没把握就跳过：识别置信度不够的块一律不填，宁可空着，绝不填错。
3. 只改开栏行：只在三个反引号后面补一个语言 token，代码内容一个字符都不改。
4. 可撤销：每个改动都是一次独立编辑，Ctrl+Z 能逐条撤销。
5. 幂等：已经填过的块，再跑多少次都不会被改动。
6. 只作用于你设置的处理目录（默认 content/posts），目录外的笔记一个不碰。

一句话：宁缺毋滥。它可能有时候漏填，但不会乱填。

使用#

启用后重载 Obsidian（Ctrl+P →「重新加载应用」），在设置 → 第三方插件里打开 Code Lang Autofill 即可。

设置项只有三个（都很直观）：

命令也保留了（不想走自动路径时）：

• 「补全当前笔记的代码块语言」
• 「补全全库（处理目录内）代码块语言」
• 「为当前代码块选择语言」

为什么我敢把它做成”自动改文件”#

市面上类似思路的插件不少，但很多是无脑填，或者检测差口气。Code Lang Autofill 把「识别」和「写入」分成了两层：

• 识别层：自研启发式 + 置信度评分，每个语言一整套特征规则；拿不准就返回”空白”，绝不硬猜。
• 写入层：接一层”插入点”再落笔，只落在开栏行的反引号后，天然可撤销、幂等。

识别层是纯逻辑、连 Obsidian API 都不碰，可以脱离 UI 直接做单元测试——整套行为（解析、易混语言判别、幂等、低置信度跳过）都用测试钉死了，这也是它有底气”自动改”的原因。

已知边界 & 小提示#

• 启发式识别不是 100%：太短的块、纯命令输出、两种语言特征太接近时，它选择跳过（安全优先）。这种时候右下角「⌄」点一下就行。
• 「记住上次语言」在”连续写同语言”的场景很好用；但如果刚写完 Python 就往新块里贴了一段 SQL，新块会被先标成 python——注意一下，用「⌄」一键改回来即可，代价很小。

项目#

• 开源、零运行时依赖，GitHub：https://github.com/tianshihao2003/obsidian-code-lang-autofill
• 欢迎使用后反馈识别不准的代码块样本，规则表就是靠真实样本一点点喂出来的。

如果你也经常为代码块没有语言标签而烦恼，装上试试，从此 ``` 后面的语言，基本不用自己打了。