「Obsidian用户必备这款插件让笔记自动排版省时又省力」

🔧 Obsidian Linter 插件详解：让笔记排版自动化的神器

📌 痛点引入

💢 做笔记的时候，你是否遇到过这些让人头疼的问题？

• 💢 写完文章发现格式乱糟糟

• 💢 有的地方多了空格，有的地方少了空行

• 💢 中英文之间没有空格，看起来很别扭

• 💢 YAML frontmatter 里标签格式不统一

• 💢 从网上复制过来的内容带着乱七八糟的格式

😅 每次手动调整这些格式，既费时又费力！

今天给大家介绍一款 Obsidian 插件，它可以帮你自动整理笔记格式，让你的笔记始终保持整洁美观 ✨

🔍 一、Obsidian Linter 是什么

Obsidian Linter 是一款专注于格式化和管理 Obsidian 笔记的插件 🔧 它的核心理念是：让用户完全掌控要应用哪些规则，确保笔记风格统一、格式规范 📋

这个插件能够处理的格式包括：

能处理的格式类型	📖 说明
📋 YAML frontmatter	文档顶部的元数据区域
# Markdown 标题	标题的大小写、层级、标点等
📝 脚注	GitHub 风格的脚注语法
📖 正文内容	引号、列表、间距等
↔️ 间距和空行	行尾空格、段落空行、多余空格等
📋 粘贴内容	自动清理复制粘贴带来的格式问题

📥 二、如何安装

✅ 方法一：从 Obsidian 内部安装（推荐）

从 Obsidian 0.9.7 版本开始，可以直接在应用内安装社区插件 📦

📌 安装步骤：

1️⃣ 打开 Obsidian → 设置 → 第三方插件

2️⃣ 点击「社区插件市场」

3️⃣ 搜索 Linter

4️⃣ 点击「安装」并启用插件

📦 方法二：手动安装

⚠️ 注意： 适合高级用户

1️⃣ 下载最新的 Release 版本

2️⃣ 解压 obsidian-linter 文件夹到你的笔记库插件目录：
<vault>/.obsidian/plugins/
3️⃣ 重启 Obsidian

4️⃣ 如果提示安全模式，关闭安全模式并启用插件

🚀 三、使用场景详解

💾 场景一：保存文件时自动格式化 ⭐最常用

每次按 Ctrl+S 保存文件时 🔄 自动整理当前笔记的格式 ✅

📌 设置方法：

1️⃣ 打开 Obsidian 设置 → Linter

2️⃣ 勾选「Lint on save」选项 ✅

📖 使用示例：

假设你写下了这样一段混乱的笔记：

# 这是一个标题
这是正文内容,这里没有空格。
- 列表项1
-列表项2（少了空格）
-  列表项3（多了空格）

这是另一段文字,英文和中文混在一起,spacing很乱。

💡 启用 Lint on save 后，插件会自动整理为：

# 这是一个标题

这是正文内容，这里没有空格。

- 列表项 1
- 列表项 2（自动添加空格）
- 列表项 3（自动调整）

这是另一段文字，英文和中文混在一起，spacing 很乱。（自动添加空格）

✨ 是不是很神奇！

🔄 场景二：切换文件时自动格式化

有时候我们编辑完一个文件 🖊️ 忘记手动格式化就切换到下一个文件了 😓

开启「Lint on File Change」功能后，每次关闭或切换文件时 🔄 插件会自动帮你整理格式 ✅

📌 设置方法：

1️⃣ 打开 Obsidian 设置 → Linter

2️⃣ 勾选「Lint on File Change」选项 ✅

🎯 场景三：手动格式化特定文件或批量格式化

除了自动模式，你还可以手动选择要格式化的范围 🎛️

操作方式	快捷键/方法	📖 说明
📄 格式化当前文件	`Ctrl+Alt+L`	快速格式化正在编辑的文件
📁 格式化当前文件夹	命令面板搜索「Lint all files in the current folder」	格式化文件夹及所有子文件夹
🗄️ 格式化整个笔记库	命令面板搜索「Lint all files in the vault」	一次性格式化所有笔记
🖱️ 右键菜单	在文件树中右键点击文件/文件夹	选择 Lint 选项

📋 场景四：自动整理 YAML frontmatter

YAML 是 Obsidian 笔记中存储元数据（如标签、日期、作者等）的区域 🏷️ Linter 提供了大量 YAML 相关规则：

规则名称	✨ 功能说明
➕ add-blank-line-after-yaml	在 YAML 区域之后添加空行
🏷️ format-tags-in-yaml	统一标签格式
📦 move-tags-to-yaml	把正文中的 `#标签` 自动移动到 YAML 的 tags 字段
⏰ yaml-timestamp	自动记录创建/修改时间
📄 yaml-title	自动从文件名或内容中提取标题填入 YAML
🔢 sort-yaml-array-values	按字母顺序排列 YAML 中的标签列表
📊 yaml-key-sort	按字母顺序排列 YAML 中的键

📌 设置示例：

打开 Linter 设置 → YAML Rules 部分，开启你需要的规则 👇

•

📦 move-tags-to-yaml：自动将正文中的 #读书 #效率 移动到 YAML 的 tags 列表中

•

⏰ yaml-timestamp：自动在 YAML 中添加创建时间和修改时间

# 场景五：标题格式化

规则名称	✨ 功能说明
🔠 capitalize-headings	将 `# this is a heading` 转换为 `# This Is a Heading`
✂️ remove-trailing-punctuation-in-heading	自动移除标题后的句号、逗号等标点
📈 header-increment	确保标题层级正确递增（H1 → H2 → H3）
📝 file-name-heading	自动将文件名同步为文档标题

✏️ 场景六：内容格式统一

规则名称	✨ 功能说明
✅ auto-correct-common-misspellings	自动更正常见拼写错误
💬 quote-style	引号样式统一（如「」或””）
➖ remove-multiple-spaces	合并多余空格
🧹 trailing-spaces	删除行尾空格
↔️ space-between-chinese-japanese-or-korean-and-english-or-numbers	中英文/数字之间自动添加空格
🔗 no-bare-urls	将裸 URL 转换为链接格式

📖 使用示例：

💢 原文：

这本书的price是$99,很划算！
他说："hello"。

✨ 格式化后：

这本书的 price 是 $99，很划算！
他说：「hello」。

📋 场景七：粘贴内容时的自动处理

从网页或其他地方复制内容到 Obsidian 时 🖱️ 经常会带入乱七八糟的格式 😫

Linter 的粘贴规则可以帮你自动清理 🧹

规则名称	✨ 功能说明
🧹 remove-leading-or-trailing-whitespace-on-paste	粘贴时清理首尾空格
📏 remove-multiple-blank-lines-on-paste	粘贴时删除多余空行
…→… proper-ellipsis-on-paste	将 `...` 转换为正确的 `…`
➖ remove-hyphens-on-paste	删除粘贴时多余的短横线
⚠️ prevent-double-list-item-indicator-on-paste	防止粘贴列表时出现双重重复

📌 设置方法：

打开 Linter 设置 → Paste Rules，开启需要的粘贴规则 ✅

⚙️ 场景八：创建自定义规则

如果你有特殊需求 🔧 Linter 还支持创建自定义正则表达式替换规则 🛠️

📌 设置步骤：

1️⃣ 打开 Linter 设置 → Custom Rules

2️⃣ 添加自定义正则表达式规则

3️⃣ 设置替换模式

⚡ 四、规则执行顺序

Linter 执行规则的顺序是固定的 📋

执行阶段	📝 说明
1️⃣ 第一阶段	需要优先执行的规则（处理 YAML 等基础结构）
2️⃣ 第二阶段	常规规则（标题、内容、间距等）
3️⃣ 第三阶段	自定义正则替换
4️⃣ 第四阶段	需要最后执行的规则（清理和优化）

⚠️ 重要提示：

如果某个规则执行时出错 💥 Linter 会立即停止并提示错误，不会继续执行后续规则

🚫 五、忽略某些文件或规则

有时候你不想对某些笔记应用所有规则 🙅 Linter 提供了灵活的排除机制 ✅

🗂️ 方法一：忽略整个文件夹

在设置中指定要忽略的文件夹路径 📂

📄 方法二：针对单个文件禁用特定规则

在笔记的 YAML 中添加配置：

---
lint:
  rules:
    disable:
      - heading-blank-lines
      - remove-trailing-punctuation
---

💡 这样这篇笔记就不会应用 heading-blank-lines 和 remove-trailing-punctuation 这两个规则了

⭐ 六、推荐的规则组合

对于大多数用户，我建议开启以下规则组合 👇

类别	推荐规则	✨ 说明
🟢 基础必开	trailing-spaces	删除行尾空格
🟢 基础必开	remove-multiple-spaces	合并多余空格
🟢 基础必开	paragraph-blank-lines	段落之间添加空行
🟡 YAML相关	yaml-timestamp	自动记录时间
🟡 YAML相关	move-tags-to-yaml	统一管理标签
🔵 标题相关	capitalize-headings	标题首字母大写（可选）
🔵 标题相关	header-increment	确保标题层级正确
🟣 内容格式	space-between-chinese-japanese-or-korean-and-english-or-numbers	中英文之间自动添加空格
🟣 内容格式	no-bare-urls	将裸 URL 转换为链接格式
🟠 粘贴相关	remove-leading-or-trailing-whitespace-on-paste	粘贴时清理空格
🟠 粘贴相关	remove-multiple-blank-lines-on-paste	粘贴时删除多余空行

⚠️ 七、注意事项

🔴 规则冲突

某些规则同时启用可能产生冲突 😱 例如「段落空行」和「两行之间添加两个空格」这两个规则有重叠部分，同时开启可能导致意外结果

💡 建议先使用默认规则，逐步添加新规则并测试效果

🔴 备份重要笔记

首次使用批量格式化功能前 📋 建议先备份笔记库，以防万一 💾

🔴 规则执行顺序

Linter 按照固定顺序执行规则 📜 如果你发现某些规则没有生效，可能是因为执行顺序的原因

✨ 八、总结

Obsidian Linter 是一款非常实用的笔记整理工具 🛠️ 它可以：

功能	📝 说明
✅	自动保持笔记格式统一
✅	节省手动调整格式的时间
✅	支持高度自定义的规则配置
✅	提供多种触发方式（保存时、切换文件、手动）
✅	支持自定义正则表达式规则
✅	兼容 Vim 快捷键

无论你是 Obsidian 重度用户 💪 还是刚刚开始使用这款笔记工具 🔰 Obsidian Linter 都能帮你大幅提升笔记管理的效率 🚀

强烈建议大家安装试用！🎉

📦 九、插件信息

项目	内容
📛 插件名称	Linter
📥 安装方式	Obsidian 社区插件市场搜索「Linter」
🔗 GitHub	platers/obsidian-linter
📖 官方文档	platers.github.io/obsidian-linter

如果觉得这篇文章对你有帮助 💖 欢迎转发分享给身边使用 Obsidian 的朋友！👥

更多 Obsidian 插件推荐和使用技巧，欢迎关注微信公众号「Obsidian黑曜石」 🔮