Quick Editing

Quick Editing is a desktop Obsidian plugin for fast Markdown transformations, smart paste, internal-link handling, text cleanup, spacing, and blank-line editing. Syntax-aware transformations protect Frontmatter, code, math, HTML, links, images, and Obsidian comments. Full-document operations show a change preview and provide an undo action.

Quick Editing is maintained by Hanser0521 from the original Enhanced Editing project, with attribution and public upstream authorization recorded in NOTICE.

Features

• Four independently configurable groups: Smart Symbols, Format Brushes, Smart Paste, and Full-document Cleanup.
• Syntax-tree-aware Markdown transformations with previews and undo notices.
• ClipboardEvent-based rich-text paste and DOM-based HTML table conversion.
• MetadataCache-aware internal links generated through Obsidian's link API.
• Searchable settings, per-command switches, and multi-window support. On Obsidian 1.13 and later, settings also participate in the global Settings search; older supported versions keep the classic plugin settings page.
• One-click removal of image links without deleting attachment files.
• Configured text and highlighter colors shown directly in the status bar format-brush menu for quick visual selection.

Language support

Quick Editing follows Obsidian's current language through the official getLanguage() API. Chinese language variants use Simplified Chinese; every other locale falls back to English. Command names, menus, settings, previews, notices, error details, and generated fallback labels are localized. Both Chinese and English command names remain searchable in the plugin settings.

Usage

1. Enable the feature groups you need in Settings → Quick Editing.
2. Search the command list to enable or disable individual commands.
3. Open Settings → Hotkeys and assign shortcuts to the Quick Editing commands you use. The plugin intentionally registers no default hotkeys.
4. Run a command from the Command palette, a configured hotkey, or the format brush toolbar. Full-document changes show an estimated change count before they are applied.

Installation

Open Settings → Community plugins → Browse, search for Quick Editing, then select Install and Enable.

Manual installation

Download main.js, manifest.json, and styles.css from the latest GitHub Release, then put the files in <vault>/.obsidian/plugins/quick-editing/. Reload Obsidian and enable Quick Editing under Community plugins.

Privacy and permissions

Quick Editing has no telemetry and makes no network requests. It reads vault metadata or note files only when a link or cleanup command requires them. It reads clipboard contents only during smart paste or the manual paste command. The plugin never deletes image attachment files; the image-link cleanup command only changes Markdown content after a preview.

中文说明

Quick Editing 是一款面向 Obsidian 桌面端的 Markdown 快捷编辑插件。它提供智能符号、格式刷、智能粘贴、内部链接、文本清理、空格与空行整理等高频操作，并为批量修改加入 Markdown 上下文保护、变更预览和撤销入口。

• 当前版本：1.0.5
• Obsidian 最低版本：1.8.7
• 支持平台：桌面端
• 实机验证：macOS、Obsidian 1.13.7
• 插件 ID：quick-editing

Quick Editing 由 Hanser0521 基于 obsidian-canzi/Enhanced-editing 继续维护。项目已更名并使用新的插件 ID，不会覆盖旧版“增强编辑”的安装目录。

功能组

关闭功能组后，该组命令不会注册到 Obsidian。更细粒度的控制可在“设置 → Quick Editing → 命令开关”中完成。

主要能力

• 链接：内部链接、同名链接、标签/双链互转、潜在链接批量转换、内链与 Markdown 链接互转，以及一键删除图片链接。
• Markdown 格式：格式刷、多彩高亮、上下划线、上下标、三浪线代码块、扩展待办状态和填空语法。
• 结构编辑：标题级别、段落选择与排序、空行增减、行首/行尾空格和中英文间距。
• 文本整理：中英文标点、外来文本、错误语法、意外断行、注释、简繁转换和路径格式。
• 辅助操作：计算选区、提取标注、修改文件名、搜索选区和列表转图示。
• 状态栏格式刷：文字颜色 1–5 与荧光笔 1–5 会直接显示对应色块；即使 macOS 启用原生菜单，也会使用可显示颜色的 Obsidian 菜单。
• 中英文界面：插件通过 Obsidian 官方 getLanguage() API 自动跟随语言；中文语言变体显示简体中文，其他语言回退为英文。命令、菜单、设置、预览、通知和自动生成的默认标签均已本地化，中英文命令名都可以被搜索。
• 新版设置：Obsidian 1.13 及以上使用可被全局设置搜索发现的声明式设置；最低兼容版本仍保留原有设置页面。

快捷键配置

Mod 在 macOS 上表示 Command，在 Windows/Linux 上表示 Ctrl。

Quick Editing 不注册任何默认快捷键，以免覆盖用户现有配置或与其他插件冲突。下面是可在“设置 → 快捷键”中手动绑定的建议组合：

其他命令默认不占用快捷键，可在 Obsidian 的“快捷键”设置中自行分配。

交由 Obsidian 核心处理的操作

Quick Editing 不再维护下列重复实现。请直接在 Obsidian“设置 → 快捷键”中搜索对应核心命令：

安装

Obsidian 官方插件库

1. 打开“设置 → 第三方插件 → 浏览”。
2. 搜索 Quick Editing。
3. 点击“安装”，然后启用插件。

手动安装

1. 从 Releases 下载最新版。

2. 将 main.js、manifest.json 和 styles.css 放入：

   <你的库>/.obsidian/plugins/quick-editing/
   

3. 重载 Obsidian，在“设置 → 第三方插件”中启用 Quick Editing。

从旧版“增强编辑”迁移

Quick Editing 使用新的插件 ID。升级后请停用旧版 Enhanced-editing，避免重复注册命令和快捷键。旧版自定义快捷键不会自动迁移，需要在 Obsidian 设置中重新分配。

开发与验证

需要 Node.js 22 或更高版本。

npm ci
npm run check

• npm run dev：监听源码并生成带 source map 的 main.js。
• npm run lint：执行 Obsidian 官方推荐的 ESLint 规则，任何警告都会使检查失败。
• npm run verify：检查版本一致性、命令 ID、类型诊断和禁止使用的 API。
• npm test：运行纯文本、粘贴、链接和设置等单元测试。
• npm run build：执行 TypeScript 检查并生成生产版 main.js。
• npm run smoke：验证构建产物能够由 Obsidian 运行环境加载。
• npm run check：依次执行上述发布前检查。

main.js 是构建产物；代码修改应提交到 src/。

许可证与来源

本项目整体以 MIT License 发布：

• 官方旧版仓库 Enhanced-Editing-legacy-version 的 0.4.4 代码原以 MIT License 发布，本仓库保留原版权声明。
• 2026 年 8 月 5 日，维护者在上游公开的 授权申请 Issue #93 中，明确申请以 MIT License 使用、修改、构建、再分发和发布衍生版本；原作者 obsidian-canzi 的公开回复为“请随意发布”。
• Hanser0521 在 2026 年新增的现代化模块、测试、工程配置和文档同样以 MIT License 发布。
• 所有历史作者和贡献者的署名均予保留，第三方依赖继续适用各自的许可证。

来源、贡献者署名与公开 Issue 授权记录见 NOTICE。版本更新记录见 CHANGELOG.md。

致谢

• 蚕子 / obsidian-canzi：原“增强编辑”插件作者。
• Mouth on Cloud：旧版仓库维护者及 MIT 许可声明保留者。
• 所有参与原项目反馈、修复和测试的贡献者。