前言
本文主要整理在obsidian使用过程中遇到的一些不合逻辑和给使用造成困扰的地方的解决方法。
将持续更新.......
一个非常棒的知识管理社区：PKMer_PKMer
关于更新
==禁止更新软件版本和插件版本，因为很多个人开发者不考虑兼容，如果要更新，请完全复制备份整个仓库再尝试==
无论是软件还是插件都要谨慎更新，如果长时间不更新突然更新，很容易出现一些莫名其妙的bug，这些bug不是因为插件有问题，也不是软件有问题，而是更新的时候应该先点击卸载完全删除这些插件，然后重新下载。而不是直接点击更新去更新。
但是完全删除之后再更新，之前的插件的配置就丢失了（有的是版本更新，旧的接口配置就丢弃了），所以如果觉得环境好用，就不要更新改动自己的obsidian环境。
链接的格式问题
尽量不要包含空格，因为会去保存对应的图片或者附件到同名的文件夹中，在链接调用的时候，这个链接也要把空格表示出来，空格用 %20 来表示。
![[./http://8.133.210.105/wp-content/uploads/articles/Tools/None/Obsidian使用/image-20240527155823534.png]]
第一张图打开了wiki链接模式，链接格式是==![[]]== 的形式，
第二张图关闭了wiki，用了markdown自带的链接格式 ==![]()==
wiki链接是可以识别文件夹名字中的空格的，但是markdown的连接格式空格必须要用==%20==来表示出来，否则是不识别的。
为了统一链接格式，后面统一关闭wiki选项，使用markdown自带的链接格式。
因为typora这种markdown的阅读器是无法识别wiki的链接格式。
而且文章上传的博客园中之后，wiki链接的格式是无法被识别的。第一个图片显示成链接，只能看到第二个图片。
视图显示
视图格式
编辑区其实有两种子模式：
源代码模式（Source mode） —— 显示原始 Markdown 语法（ # Obsidian使用 等符号都可见），不做任何渲染
实时预览模式（Live Preview） —— 这是默认模式，很多人容易和"源代码模式"混淆。它会把 Markdown 语法实时渲染成效果（比如 粗体** 显示成真正的粗体），但光标所在行/选区仍会显示原始语法方便编辑。这是目前 Obsidian 默认给新用户开启的模式。
再加上非编辑的阅读模式：
阅读视图（Reading view） —— 完全渲染后的只读展示，不能编辑，所有语法都变成最终排版效果
这三种模式中，默认打开的是实时预览模式，也是最常用的一种。切换实时预览的方式是点击文章右上角的书本标记。
源代码模式和编辑模式混乱
类似下面这种尖括号里面有东西的，会使从当前位置开始后面都是源代码模式。所以要在尖括号前面加上转义。
\
原因是会把这种尖括号的内容解析为html，但是html不能使用markdown语法。
自动套用模板和存放笔记
Obsidian自动化套用模板与存放笔记 – 月离万事屋 (yuelili.com)
插件
Find orphaned files and broken links
==经过测试发现这个插件在查找方面有很大的缺陷，会误识别已经使用的文件为孤立文件，这是极其危险的，建议只使用它查找空文件的能力==
“Find orphaned files and broken links”插件是Obsidian用户管理笔记库的强大工具。通过自动识别孤立文件、损坏的链接和空白文件，它帮助用户保持笔记库的整洁和有序。同时，插件还提供了丰富的自定义设置和附加功能，以满足不同用户的需求。对于任何希望提高笔记库组织效率的Obsidian用户来说，这个插件都是一个值得尝试的有用工具(来自AI)。
在命令行中执行find broken links脚本，会将所有查找到的所有损坏的链接都放在根目录下的broken links output(默认)。
从上往下七个命令依次是：
1. 查找空的文件
2. 查找损坏的链接
3. 删除空文件（1命令中查出来的）
4. 查找出孤立的文件（没有被任何文件引用）
5. 查找没有标签的文件
6. 会把2中查到的没有实际文件的链接，都创建一个空的文件在对应位置
7. 允许用户删除具有特定扩展名的孤立文件，如jpg、png等图片文件，这个文件类型需要在设置中设置。
4查找的文件并不准确，有的图片链接被文章使用了依旧会被检索出来是孤立的图片，因此谨慎使用7的删除操作，这是极其危险的，因为他的检索方式十分差劲。
查找的结果都会在根目录下创建文件存放，谨慎使用删除操作。
Clear Unused Images
这是一个清除未被引用图片的插件。
==请远离这个插件，这个插件也是无法准确识别有些图像的链接，会误删，而且这个插件是自动删除，如果你没有其他的管理备份手段，恢复起来很麻烦==
2026.07.14
可以使用此插件清理，但需提前勾选“删除到 Obsidian 的 .trash 文件夹”，方便误删后恢复。
删除完成后会弹出一个删除清单窗口，千万不要关掉。一旦关闭，后续就无法查询删除了哪些文件。这时需要按 Ctrl + Shift + I 打开 Obsidian 控制台，选中弹窗内容，复制后交给 AI，让 AI 解析本次弹窗所删除的文件列表。
然后请 AI 编写一个 Python 脚本，去检查这些文件在笔记系统中是否真的被删除了——即直接搜索笔记系统中是否还包含这些文件名。需要 AI 生成两份文件：一份删除清单，一份 Python 脚本。
我通过这种方式检查，发现有不少误删的文件，需要逐一手动恢复。
C:\Users\dong.wang\Desktop\check_by_filename.py --vault "D:\jianguoyun\document" --names "C:\Users\dong.wang\Desktop\删除图片文件名列表.txt" --report "C:\Users\dong.wang\Desktop\result.md"
[i] Loaded 136 filenames to check.
[i] Scanning 189 markdown files in vault...
===== SUMMARY =====
Total checked : 136
Confirmed orphaned : 117
STILL REFERENCED : 19 <-- review these!
===== WARNING: files still referenced somewhere =====
- 9e7d790cacab9fbd5e3f4f31ba691715.png
referenced in: Study\wayland.md
- 8c6b079a06f4b47c187c0e59da1d4a06.png
referenced in: Study\wayland.md
......
常见的问题是：
这种标签的引用方式会出现问题，不要使用这种方式引用图片。
<div align="center"><img src="typora-images/python3.7和openssl版本不兼容/image-20230329175453256.png"></img>