## **List callouts** 更好的列表处理



## **Minimal主题**

[Home - Minimal Documentation](https://minimal.guide/home)

通过[obsidian-minimal-settings](https://pkmer.cn/Pkmer-Docs/10-obsidian/obsidian%E7%A4%BE%E5%8C%BA%E6%8F%92%E4%BB%B6/obsidian-minimal-settings) 插件可以对主题样式进行调整插件可以对主题样式进行调整，下面是主题的主要设置项：

Color scheme: 选择预定义的主题外观 (个人倾向于 Notion、Atom)
Features: 常用特性的开关, 比如
Colorful active states
Colorful headings
Focus mode: 建议在状态栏新建开关按钮
Layout: 默认即可
Typography: 字体和行宽等设置, 除字体大小其余默认即可

通过 [obsidian-style-settings](https://pkmer.cn/Pkmer-Docs/10-obsidian/obsidian%E7%A4%BE%E5%8C%BA%E6%8F%92%E4%BB%B6/obsidian-style-settings) 插件可以对主题样式进行调整

代码使用方式，进入 style setting 插件设置 import 导入
## ZettelFlow



## 输入时间更自然：Natural Language Dates

无论是日记、周志，还是在待办中，时间都是出现频率极高的那一类词汇。而在输入时间时，「x 年 x 月 x 日」这样表述像机械般生硬，「今天」、「明天」或「下周一」这样的说法才显得自然。因此，很多待办应用都支持了自然语言键入。Natural Language Dates 为 Obsidian 带来了这一特性。

它主要有三个功能：设置后使用快捷键迅速输入时间、日期；键入「`@` + 自然语言」自动转换为日期；将现有的自然语言通过快捷键或动作（Action）转换为日期。

## Excalidraw



## Callout manager


![](https://cdnfile.sspai.com/editor/u_/c4f8trtb34tb094k5bfg.gif)

## List Callouts

List Callouts 插件则是实现了两者结合的作用，在大纲列表上，通过设定的字符符号，生成对应的强化图标和强调高亮色。

- & 

- ! 

在列表项的开头键入自定义字符，可将对应列表项转换成特殊样式。你可以理解成一种更轻量化的高亮标记方法。

**使用**
输入：在大纲列表项的开头键入一个字符（可配置）将对应列表项变成一个高亮样式。
如原来输入是 `- 我是列表项`，现在输入是：`- & 我是列表项
预设样式：触发字符，可以自己设定，内置 7 种常用的符号和常用颜色。
内置 7 种预设样式，这些样式修改触发字符，和图标样式。
不能修改对应的高亮颜色
**自定义样式**
如果你对预设的样式不满意，或者觉得数量不满足你的诉求
该插件提供新增功能， 使用插件设置中的 Create 可以创造全新的样式
该插件中的样式，已经和 obsidian-style-settings li 可以使用样式设置插件调整标注的填充。

## 改善超链接：Paste URL into Selection 和 Auto Link Title

Paste URL into Selection 做的事情非常简单。假设我们剪贴板首位为链接 `「[https://example.com]」`，此时选中一段文字「TEXT」，粘贴，这个链接就会和文字结合在一起成为 `「 [TEXT](https://example.com) 」`。

该插件的设置界面有一个条目控制当没有文字选中时粘贴链接的行为，如果我们使用了自动格式化图片链接的软件（如 ShareX，Picgo autocopy），建议选择「Do Nothing」。

Auto Link Title 则会在粘贴链接的时候自动抓取网页的标题，填充为文字。

## 让 Wiki 链接方便：Note Refactor


默认情况下，使用双中括号可以唤出 Obsidian 的标题建议界面，并创建 Wiki 链接。但如果我们想要为已经写过的文字创建 Wiki 链接呢？这时候我们可以使用 Note Refactor 插件。

我们只需要选中一段文字，然后按下设置的快捷键，就能以这段文字为文件名创建新笔记，并在新的面板打开。如果笔记已经存在，会打开这个存在的笔记。

此插件还能够实现根据标题将一个大文档拆分的效果，拆分后的小文档会在原文档留下 Wiki 链接。
![](https://cdnfile.sspai.com/editor/u_/c4f8tstb34tb0h9pkno0.gif)
## 让列表更智能：Outliner
首先，它严格限制了列表的层级：一级列表后只能插入二级列表。其次，它让列表的编辑更方便：只需光标在一个列表条目，就能使用 Tab 对它进行操作，Ctrl + A 此时也不会再选中全文，而是一个小条目。此外，Outliner 还给列表的编辑界面添加了类似代码编辑器那样的层级样式，让它们看起来更有条理。

如果想要使用此扩展，强烈建议你为以下五个操作添加顺手的快捷键：

1. 有序/无序列表：用于切换列表样式。
2. 折叠/展开当前行：用于展开折叠列表；需要在设置中打开「折叠缩进」选项。
3. 段落的上移/下移：用于快速调整列表条目的位置。Outline 插件设置中有相似的动作，但建议直接使用 Obsidian 本体提供的快捷方式，适用范围更广。




## 让插入表格更简单：Advanced Tables


只需要输入「`|` + 作为标题的文字」，再按下 Tab，就会触发插件的自动补全语法。之后通过 Tab/Shift + Tab 来在表格之间移动光标，通过 Enter 完成输入，不多时一个好看的表格就写完了。

同时，像上图展示的那样，它还有浮动的工具栏，提供了快捷键之外的表格编辑选择。

## 代码高亮：Editor Syntax Highlight

无需多言，只要在 Obsidian 中记录代码的需求，Editor Syntax Highlight 就是必装插件。它能让编辑界面的代码，页面的元数据都有高亮效果。
## **让 Markdown 更统一：Markdown Prettifier**

我习惯把 Markdown Prettifier 的快捷键设置成 Ctrl + S，按下此快捷键后，插件会按预先的配置将文章的 Markdown 格式规范和统一。比如将所有的无序列表标记统一置换为 `-`。
Markdown Prettifier 还有一个非常好用的功能：更新文件的元数据。勾选插件设置中的「Update header」和「Add new headers」，在 header 设置中填入模板，例如 `updated:'{{date:YYYY-MM-DD HH:mm:ss}}'`，它会在按下快捷键后更新笔记中的 `updated` 一栏的数据为当前时间，如果没有相关的条目，则会自动补充。

## Simplified Chinese Word Splitting

## Easy typping
编辑增强
1. 自动补全，打出左边的符号补全右边的符号。
2. 中文输入法下，编辑增强，如选中 code ,中文输入法的引号可以变成 `code`
3. 两次中文输入法转为一个英文输入法的符号，但是 `【 【` 会变成 `[[`
4. 基础输入增强，启用核心插件中的斜杠命令，句首中文的顿号转换成"/"，两个中文的左上角会变成英文的单引号，再一个会变成三引号；￥符号也是
5. TAB 键跳出公式 

自定义规则
自动格式化
```text
规则编辑面板
点击 +（添加）或齿轮图标（编辑）会打开规则编辑面板。面板分为以下几个区域：

基本设置
字段	说明
类型	三种规则类型，决定规则何时触发（见下文）
触发方式	自动触发还是按 Tab 触发（仅输入规则可见）
三种规则类型：

类型	触发时机	典型用途
输入	输入文字时自动触发	文本替换、符号转换、代码片段
删除	按退格键时触发	删除配对符号
选中替换	选中文字后输入字符时触发	给选中文字加包裹符号
两种触发方式（仅输入规则）：

模式	说明
自动	输入时模式匹配后立即触发（默认）
Tab	输入模式后需按 Tab 才触发，避免正常输入时意外展开
匹配条件
字段	说明
光标前匹配	光标左侧需要匹配的文本。选中替换类型下为"触发按键字符"
光标后匹配	光标右侧需要匹配的文本（可选，选中替换类型不可用）
使用正则表达式匹配	开启后，光标前/后匹配字段将作为正则表达式解析
正则标志	仅在开启正则匹配时可见，目前支持 i / m / u
关于匹配方式：

默认为纯文本匹配——你填什么，就精确匹配什么
开启"使用正则表达式匹配"后，可以使用正则表达式的完整语法（如 \d+、[a-z]+、(.*?) 等）
当前支持的正则标志：
i：大小写不敏感
m：多行模式（^ / $ 匹配行首行尾）
u：Unicode 模式（支持更完整的 Unicode 字符与 \p{...} 属性匹配）
规则引擎仍然要求匹配紧贴光标：
左侧匹配必须以光标左边结束
右侧匹配必须从光标右边开始
选中替换规则的"触发按键字符"字段中，每个字符都是一个独立的触发键（如填 【￥ 表示 【 和 ￥ 都能触发）
替换
字段	说明
使用函数式替换	开启后，替换内容字段变为 JavaScript 代码编辑器
替换内容	匹配成功后用来替换的文本（支持模板语法，见下文）
其他
字段	说明
作用域	可多选，限定规则生效的上下文
语言	限定到特定代码块语言，如 python（只要作用域包含"代码"就可见）
优先级	数值越小优先级越高，默认 100
描述	方便自己辨认的备注
作用域选项：

选项	含义
全部	任何上下文都生效（默认）
文本	仅在普通 Markdown 文本中生效
公式	仅在 $...$ 或 $$...$$ 内部生效
代码	仅在围栏代码块内部生效
可以组合多个作用域，例如“文本 + 代码”。
如果同时设置了“代码语言”，该语言限制只会在代码作用域下生效，不会影响文本或公式作用域的匹配。

替换模板语法
替换内容支持以下特殊语法：

Tabstop 占位符
语法	含义
$0	替换后的主光标位置
$1、$2...	额外的光标位置（用 Tab 依次跳转）
${1:默认文本}	带默认文本的占位符（Tab 跳转时文本被选中）
光标跳转顺序为 $0 → $1 → $2 → ...

捕获组引用（需开启正则匹配）
语法	含义
[[0]]	光标前匹配的整个匹配结果
[[1]]、[[2]]...	光标前匹配的第 n 个捕获组
[[R0]]	光标后匹配的整个匹配结果
[[R1]]、[[R2]]...	光标后匹配的第 n 个捕获组
[[n]] 优先取左侧分组；如果左侧没有该下标，回退到右侧。使用 [[Rn]] 显式引用右侧。

特殊变量（选中替换规则）
语法	含义
${SEL}	选中的文本
${KEY}	触发的按键
转义序列
输入	输出
\n	换行符
\t	Tab
\r	回车
\\	字面反斜杠
注意：在面板中直接输入 \n 就代表换行，不需要写成 \\n。但在 JSON 文件中，由于 JSON 本身的转义规则，需要写成 \\n。

```
其余快捷键

## Editting Toolbar
## 同步与备份：Git

作为有计算机背景的用户，提到同步时我天然就比较倾向于使用 Git 来实现同步。严格来说，Git 是一个分布式版本控制系统，其设计重点在于让多个版本能够有效协作，我们将其用于同步或者备份是「重器轻用」的做法。

要使用 Git 同步，你需要先在本地安装 Git，配置好邮箱以及用户名之后才能使用；之后，你需要有一个**公网可访问**的 Git 服务器来负责在多个设备之间同步内容。国内外免费的 Git 服务器很多，最有名的是 Github，但是由于其访问不够稳定所以我比较推荐使用国内的 [Gitee](https://sspai.com/link?target=https%3A%2F%2Fgitee.com%2F) 来作为笔记同步的 Git 服务器。

为了避免频繁地输入密码，我建议你在配置好 **SSH 密钥**或者**令牌**。配置这个对于没有计算机背景的用户来说会比较麻烦，但是作为一个几乎经常碰见的问题，网络上已经有很多手把手教程可以为你提供帮助。在 SSH 密钥和令牌之间我更加推荐**令牌**。一方面是配置令牌比较简单，另一方面是令牌可以实现更加细致地授权因而更加安全。如果你觉得比较复杂，可以让 ChatGPT 或者 deepseek 手把手教你配置。

**Git 同步不是像 webdav 一样的实时同步，而是手动同步**。你必须手动点击上传、下载才能更新云端和本地的内容。原版的 Git 有大量同步和备份用不上的版本控制操作，Obsidian 的 Git 插件对此作出了简化。正常使用的时候你只需要注意下面三个按钮，分别代表上传、下载和刷新（当你发现自己的更新没有显示的时候就刷新）：

![](https://cdnfile.sspai.com/2025/02/13/article/1eae660caac0b41ff76db692c7bcc5aa.png?imageView2/2/w/1120/q/90/interlace/1/ignore-error/1/format/webp)

只要云端和彼此同步的多台设备没有全部损坏，笔记内容就不会丢失。因此 Git 可以同时实现笔记的同步以及备份。

> 由于写代码本质上就是在编写文本，和文字工作是一样的。因此我认为做文字工作也可以使用 Git 来进行版本管理以及控制。



## 长文写作：[[Longform]]

## pandoc plugin
转换格式的插件；

## pandoc reference list
显示 CSL 的格式，可以查看你引用了哪些参考文献；

## 图片工具箱：Image Converter

Image Converter 经过了一轮大更新之后成功打破了局限，进化为了集图片格式转换、图像压缩、图片编辑、位置调整等许多功能于一身的图片工具箱，有效弥补了 Obsidian 几乎无法操作图片的缺陷。

安装了 Image Converter 之后，只需要右键文章中的某个图片，就可以显示一系列图像操作：

我们可以这样轻松地实现：

1. **复制图片**：不再需要去文件管理器里面找对应的图片就可以直接复制；把 Obsidian 中的文章分享到其他平台往往需要逐个粘贴图片，有了这个就会方便很多；
2. **修改图像大小**：将鼠标置于图像上，按住 shift，滑动滚轮就可以调整图像大小；而且这样的调整方式不会修改原图像；
3. **修改图像位置**：可以自由调整图像的居左、居中、居右以及文字环绕，并且不会修改文章的源码；
4. **对图像进行复杂的编辑**：可以很方便地在软件内实现图像旋转、加文字注释、涂改、镜像翻转、裁剪这类操作；
5. **自动为图像命名**；
6. **在文章中删除图片的同时删去对应文件**。


## BART
安装未上架主题

## MySnippets

更方便地管理 CSS 片段

## Commander

## Hider

## Style setting
## Custom attachment  Location
##  Clear Unused Images
## custom file explorer sorting

## attachment mangement

## SnipDock

## surfing

## Linter
## Zotero Plugin
联动 zotero 的关键插件
## pseudocode

## **中文增强：Fuzzy Chinese Pinyin**

Obsidian 作为一个为英文设计的笔记软件，内置的搜索是不支持中文拼音模糊搜索的。Fuzzy Chinese Pinyin 之后就可以在快速切换中使用拼音模糊搜索了。除了搜索文件之外，最重要的是 Fuzzy Chinese Pinyin 还支持双链搜索时的模糊拼音建议。即我使用 `[[` 搜索文件时也可以使用拼音模糊搜索，并且还可以在文件内部搜索标题块时使用拼音模糊搜索。这可以大大改善中文用户的搜索体验。
## Completr

[[Obsidian四大金刚：Templater、QuickAdd、Dataview、Excalidraw]]
[[Obsidian数学公式类插件]]

## 有用但不必要的插件

我说的在 Obsidian 中有用但是不必要的插件是指**其有一定功能，但是和写作/写笔记关系不大**的插件。比如在第三方市场排名第一的 Excalidraw 以及 Tasks、Kanban、Calendar 这类插件。这些插件本身都质量很高，但是其并不提供写作相关的功能，偏离了 Obsidian 作为一款笔记/写作软件的定位。Excalidraw 是一个和 Draw.IO 一样的作图软件；Tasks 是一个和滴答清单一样的任务管理软件；Kanban 是一个工作面板；而 Calendar 是一个日历。

> 按照这个标准，Obsidian 官方推出的白板也属于有用但是不必要的插件。

Dataview 是一个介于必要和不必要之间的插件。其为我们透视笔记之间的关系提供了途径，但是又不是直接为写笔记服务。在我这里，Dataview 的使用频率不高，主要是给 Homepage 装点门面或者偶尔做统计的时候会用到。

## 快捷键设置很重要

当然，想要在编辑的时候不手忙脚乱，还得依靠方便好记的快捷键。但每个人的系统环境不同，个人习惯也不同，方便与否还得靠自己尝试。这里展示我自己在 Windows 下的快捷键绑定原则和大部分快捷键列表，供大家参考。

- Ctrl 键可以和几乎所有键绑定，不与其他软件设置冲突即可。
- Shift 键一般不作为修饰键，因为会和输入冲突。
- Ctrl + Shift 键是 CTRL 的增强功能或者对应功能。
- Alt 键尽量不和字母键绑定。在 Ctrl 键被占用的情况下使用。

## 总结
推荐了这么多插件，其实只是想让 Obsidian 的编辑体验更好一点而已。但这是 Obsidian 的问题吗？更深层次的原因应该是 Markdown：虽然它期望将编辑和排版完美结合，但结果，既不能方便地搞定复杂多变的排版；也将一部分文字内容的编辑复杂化，输入的无意义标记比正文还多。放眼望去，几乎所有支持 Markdown 主流笔记软件都要考虑如何优化自己的输入体验，或者像 Notion 那样用各类关键词来引导创建格式，或者像本文一样采用各种快捷键，或者兼而有之。

如果是这样的话，Markdown 为何还有如此多的人使用？它确实简化了诸如标题，序号等格式的输入方式，但一些富文本编辑器目前也能做到。我想，最重要的是，Markdown 作为文本文件所独具的通用性。不如换一种问法：为什么用 Obsidian 记录？—— 它既不会像 Evernote 搞一套别的软件都识别不了的格式，也不会像 Notion 那样将文件名称搞的乱七八糟。在 Obsidian 上编辑的，同样能在 GitHub，VScode 和 Markor 上正常打开和渲染。这自然归功于简单，通用的 Markdown。

那么，为什么不使用其他本地 Markdown 笔记呢？因为 Obsidian 给笔记间搭建了联系的桥梁，并有着强大丰富的扩展体系，正如本文展示的那样。


## 文理科的分类

### 一、理工科专用

|插件|用途|
|---|---|
|obsidian-latex-suite|LaTeX公式快速输入|
|mathlive|可视化公式编辑器|
|math-booster|数学环境（定理、证明等）|
|obsidian-tikzjax|渲染TikZ矢量图|
|pseudocode-in-obs|算法伪代码|
|code-emitter|运行代码并嵌入输出|
|obsidian-linter|格式化代码/数学环境|
|mathlinks|数学笔记双向链接|

---

### 二、文科专用

| 插件                       | 用途             |
| ------------------------ | -------------- |
| obsidian-calibre-plugin  | 连接Calibre管理电子书 |
| obsidian-kindle-plugin   | 导入Kindle高亮     |
| obsidian-weread-plugin   | 导入微信读书笔记       |
| bookshelf                | 阅读书目管理         |
| obsidian-table-generator | 可视化生成表格        |
| table-editor-obsidian    | 表格编辑增强         |
| easy-typing-obsidian     | 中英文混排优化        |
| url-into-selection       | 链接快速转为超链接      |
| cm-chs-patch             | 中文分词/拼写检查      |

---

### 三、通用（理科+文科都能用）

|插件|用途|
|---|---|
|dataview|数据查询与表格|
|templater-obsidian|高级模板|
|obsidian-tasks-plugin|任务管理|
|obsidian-excalidraw-plugin|手绘/流程图|
|better-export-pdf|增强PDF导出|
|custom-sort|自定义排序|
|editing-toolbar|浮动工具栏|
|obsidian-hider|隐藏界面元素|
|open-in-new-tab|新标签页打开|
|oz-clear-unused-images|清理未引用图片|
|remotely-save|第三方云同步|
|obsidian-minimal-settings|Minimal主题设置|
|obsidian-style-settings|样式自定义|
|cmdr|自定义命令按钮|
|snipdock|浮动侧边栏|
|quick-preview|快速预览链接|
|obsidian-completr|自动补全|
|image-converter|图片压缩/转换|
|obsidian-image-auto-upload-plugin|自动上传图床|
|media-slider|音视频进度控制|
|callout-manager|自定义Callout样式|
|heading-toggler|标题折叠展开|
|codeblock-tabs|代码块标签页|
|emoji-shortcodes|Emoji快捷输入|
|ozan-image-in-editor|编辑器中显示图片|
|zettelflow|卡片盒工作流|
|obsidian42-brat|安装Beta插件|
|surfing|内置浏览器|
|list-callouts|列表项高亮|