Obsidian Editing Toolbar 插件使用教程

项目介绍

Obsidian Editing Toolbar 是一个为 Obsidian 笔记应用设计的插件，提供类似于 Microsoft Word 的工具栏，增强文本编辑体验。该插件基于 cmenu 插件开发而来，经过重新设计和功能增强，支持多种编辑功能，包括文本格式化、插入特殊字符等，让用户在 Obsidian 中的写作和编辑更加高效便捷。

项目快速启动

安装步骤

1. 克隆项目仓库：

   git clone https://gitcode.com/gh_mirrors/ob/obsidian-editing-toolbar.git
   

2. 进入项目目录：

   cd obsidian-editing-toolbar
   

3. 安装依赖：

   npm install
   

4. 构建项目：

   npm run build
   

5. 将构建好的插件文件复制到 Obsidian 的插件目录：

   cp -r dist ~/.obsidian/plugins/obsidian-editing-toolbar
   

6. 在 Obsidian 中启用插件：

   • 打开 Obsidian，进入设置页面
   • 选择"社区插件"，然后点击"浏览"
   • 找到"Editing Toolbar"插件并安装
   • 安装完成后，启用该插件

核心功能特性

Obsidian Editing Toolbar 提供以下核心功能：

• 多种工具栏布局：支持顶部模式(Top)、跟随模式(Following)、底部模式(Fixed)和移动端工具栏(Mobile)
• 视图显示控制：可根据不同视图类型（如Canvas、Excalidraw、图片等）控制工具栏显示
• 多配置管理：支持为不同位置的工具栏创建独立配置方案
• Markdown格式刷：快速批量应用文本样式到其他文本段
• Callout格式刷：自动识别callout类型并应用到其他文本
• 主题适配：支持与Obsidian主题同步或手动选择深色/浅色模式
• 自定义命令：支持创建自定义格式命令和正则表达式命令

详细功能解析

工具栏配置与管理

工具栏位置设置：

• 顶部模式(Top)：固定显示于编辑器顶端，适合传统文字处理软件用户
• 跟随模式(Following)：动态定位当前编辑位置，自动避开界面边缘
• 底部模式(Fixed)：固定于编辑器底部区域，保持界面整洁

视图显示控制： 支持按视图类型管理工具栏显示，点击状态栏工具栏图标即可进行单独设置或批量配置。

高级功能使用

Markdown格式刷：

1. 先点击需要设置格式的按钮（如"B 加粗"）
2. 点击工具栏中的"Format Brush"按钮（默认图标为画刷）
3. 选中目标文本，格式将自动应用
4. 点击鼠标中键或右键可终止格式刷

Callout格式刷： 选中callout文本后，可自动识别callout类型（note、tip、warning、danger、info、success、question、quote），通过格式刷即可对其他文本应用callout样式。

自定义功能开发

自定义格式命令： 支持用户设置自定义格式规则并生成命令添加到工具栏，主要功能是为选中文本添加自定义前缀和后缀。

自定义正则表达式命令： 支持通过正则表达式定义复杂文本替换或格式化规则，内置多种常见案例，方便用户快速使用。

应用案例和最佳实践

案例一：学术论文写作

使用 Obsidian Editing Toolbar 插件，学者可以在撰写学术论文时快速格式化文本，插入引用和参考文献，提高写作效率。通过工具栏快速插入脚注和尾注，使得论文格式更加规范。

案例二：技术文档编写

技术作者可以使用该插件快速插入代码块、调整文本格式，使得技术文档更加清晰和易读。通过工具栏快速插入代码块，并设置代码语言，提高文档的专业性。

最佳实践

• 自定义工具栏：根据个人需求，自定义工具栏上的按钮，添加常用功能
• 快捷键绑定：为常用功能设置快捷键，提高操作效率
• 多窗口管理：利用插件支持的多窗口功能，同时编辑多个笔记，提高工作效率

典型生态项目

Obsidian 社区插件

Obsidian 拥有一个活跃的社区，提供了许多有用的插件，如：

• Dataview：用于数据查询和展示
• Templater：用于创建和管理模板
• Advanced Tables：用于创建和编辑表格

这些插件与 Editing Toolbar 结合使用，可以进一步提高 Obsidian 的使用效率和功能性。

常见问题排查

1. 工具栏未显示

   • 确认插件启用状态及视图设置
   • 重启Obsidian或更新Editing Toolbar到最新版

2. 命令无效

   • 插件设置--右上角扳手--使用"Fix Commands"修复

3. 反馈问题

   • 提交至Issues，附上复现步骤和Obsidian版本

通过本教程，您可以充分利用 Obsidian Editing Toolbar 插件的强大功能，提升在 Obsidian 中的编辑体验和工作效率。