Obsidian手册

一 默认设置

1. 修改字体为仿宋；修改字号为20
2. 注意插件需要软件重启后生效

二 多库设置同步

使用原理为Windows系统下的文件夹同步，mklink 命令是将文件或目录建立双向连接, 改变任何一方都会发生变化，详细文件夹使用删除参见链接2.
此处说明基本使用语法：

mklink [[/D] | [/H] | [/J]] Link Target

其中

  /D 创建符号目录连接,(软连接)
  /H 文本文件链接(硬连接)
  /J 创建目录连接(软连接)
  Link 要创建新链接的文件
  Target 源文件
  ------------------------------------------------------
  参数 /D 和 /J 都是建立目录连接, /H 是建立文件链接
  ------------------------------------------------------

电脑端设置根目录为C:\jgy\obsidian\.obsidian；以C:\jgy\obsidian\.obsidian为跟目录举例，在其他文件夹下设置软链接
切换到同一盘符文件夹下

cd XXXX

mklink /j /d  .\.obsidian C:\jgy\obsidian\.obsidian

三 快捷操作

1 常用快捷键

1. 在快捷键设置中，找到 与上一行互换和 与下一行互换，设置为 alt+上方向键 alt+下方向键即可使用快捷键移动行和段落了
2. 文件列表面板在左上方，大纲面板在右上方
3. 引用代码code 快捷键需要自己设置，快捷键设置中搜索代码块，设置快捷方式为 `contrl +``

2 默认快捷键

Obsidian 快捷方式总结

1. 对文字的格式刷-快捷方式
   加粗：text 快捷键：Ctrl + B
   右倾斜：text 快捷键：Ctrl + I
   划掉文字：text
   高亮文字：text
   引用代码：code
   公式：$math$ 快捷键：Ctrl + /
   注释：%% text %%
2. 对段落的格式化-快捷方式
   无序列表：- 无序列表 （行首使用）
   有序列表：num. 有序列表 （数字+“.”+“文本”）
   代办事项：- [x] 或 - [] 快捷键：Ctrl + L
   大标题：### paragraph
   引用：> 引用 或 > [!tip]
3. 插入-快捷方式
   水平线：— （需要空两行使用）
   数学公式块：$$Math$$
   代码块：python
4. 键盘快捷键
   F快捷键类
   F1 —— 查看帮助
   F2 —— 编辑所在文档的文件名
   F11 —— 全屏
5. 标签相关
   Ctrl + Tab | Ctrl + PageDown —— 下一标签
   Ctrl + Shift + Tab | Ctrl + PageUp —— 上一标签
   Ctrl + Alt + ← —— 在窗口返回
   Ctrl + Alt + → —— 从软件返回桌面
   创建标签类
   Ctrl + T —— 新建标签页
   Ctrl + Shift + N —— 在右侧创建标签页
6. 其他类
   • Ctrl + , —— 打开设置
   • Ctrl + ; —— 增加当前文档的属性
   • Ctrl + K —— 插入链接
   • Ctrl + W —— 关闭当前标签页
   • Ctrl + Shift + W —— 关闭所有标签页

3 更改快捷键

使用增强编辑插件

1. 安装
   手动下载最新的压缩包，然后将其中文件(main.js, manifest.json) 解压到 库目录/.obsidian/plugins/ZH增强编辑 文件夹即可.
2. 设置快捷键即可
   

四 Markdown转换为其他格式

原网页

1. Pandoc 软件

Pandoc 的出现就是为了解决这个问题。它就是一把「瑞士军刀」，可以实现多种文本格式的相互转换，不仅可以把 md 文件导出为 Word，还可以导出为 PDF、ePub 甚至是 PPT，更多的格式转换可以查阅官网。
使用方法是下载安装 Pandoc，通过以下的一个命令行就能实现文件的转换。

pandoc 文件名.md -s -o 文件名.docx

2. Obsidian 集成 Pandoc

单独使用 Pandoc 需要用命令行操作指令，并不友好，我常常忘了具体的指令是什么，用到的时候需要上网搜一下。Obsidian 集成了 Pandoc，可以通过图形化的界面实现文本之间的格式转换。

具体步骤如下：

1、安装 Pandoc 软件。
2、安装 Obsidian 的 Pandoc 插件。
3、在 Obsidian 的 Pandoc 插件设置中配置 Pandoc path，即 Pandoc 程序的路径。 /opt/homebrew/bin/pandoc (Mac)或者 C:/Program Files/Pandoc/pandoc.exe(Windows)。

4、原网页文档源格式是以html还是markdown格式导出，这里是能否正确显示图片的关键，下面会重点说

[

1. 图片格式如果是图床形式，比如http或者https开头测试均可正常导出并识别。
2. 图片格式如果是本地图片。这里分两种情况

• wiki格式的图片 格式为![[XXXX.png]] 这类的 需要pandoc中设置源格式html才可以正确识别。

• md格式的图片 格式为![](XXXXX.png) 这种格式需要pandoc设置源格式为markdown才可以正确识别。

5、完成配置之后，打开需要导出的文档，通过 Command+P（Windows 上是 Ctrl+P）调出命令面板，选择导出格式。

五 插入文件

你可以通过相同的语法将 PDF 文件嵌入到你的笔记中。除此之外，你可以通过 ![[My File.pdf#page=number]] 这样的形式直接指定嵌入 PDF 文件的页码。
当你拖动图片到笔记中时，图片会自动嵌入笔记，并且 Obsidian 会将图片文件复制到默认的附件文件夹中。Obsidian 支持几种图片格式，因此大多数情况下你都可以在文件列表中的附件文件夹中选择并查看图片。

1 嵌入笔记

当然，你可以通过相同的语法将一篇笔记嵌入到另一篇笔记中，比如：
支持格式
目前为止，Obsidian 支持以下格式的文件：

1. Markdown 文件：md;
2. 图像文件：png, jpg, jpeg, gif, bmp, svg;
3. 音频文件：mp3, webm, wav, m4a, ogg, 3gp, flac;
4. 视频文件：mp4, webm, ogv;
5. PDF 文件：pdf.
   以上类型文件都可以内嵌到笔记页面中

六 常用插件

1 Style Settings

1. 更改页边距
   • 通过更多样式中设置行宽数值更改页边距（设置为88刚好）
2. 可以通过搜索-安装主题设置不同的主题样式
   • blue topaz theme
3. 更改行内代码样式
   

2 思维导图插件

1. Enhancing mindmap
   • 看评论该插件会丢数据 https://zhuanlan.zhihu.com/p/430822187
2. obsidian mark mind
   • https://publish.obsidian.md/chinesehelp/01+2021%E6%96%B0%E6%95%99%E7%A8%8B/%E5%9C%A8OB%E4%B8%AD%E7%BB%98%E5%88%B6%E6%80%9D%E7%BB%B4%E5%AF%BC%E5%9B%BE%EF%BC%88Enhancing+mindmap%E6%8F%92%E4%BB%B6%E4%BB%8B%E7%BB%8D%EF%BC%89+by+%E8%BD%AF%E9%80%9A%E8%BE%BE
   • https://cyddgh.github.io/post/202107051942/
   • 用着还可以

3 编辑bar插件

1. cMenu
   • 相关网站：https://pkmer.cn/Pkmer-Docs/10-obsidian/obsidian%E7%A4%BE%E5%8C%BA%E6%8F%92%E4%BB%B6/cmenu-plugin/
   • 通过控制显示还是隐藏

4 日历插件

Calendar

https://sspai.com/post/67619
https://pkmer.cn/Pkmer-Docs/10-obsidian/obsidian%E7%A4%BE%E5%8C%BA%E6%8F%92%E4%BB%B6/calendar/

5 增强编辑

6 看板插件

1. 参考链接
   • https://pkmer.cn/Pkmer-Docs/10-obsidian/obsidian%E7%A4%BE%E5%8C%BA%E6%8F%92%E4%BB%B6/obsidian-kanban/#%E4%BD%BF%E7%94%A8
   • https://www.bilibili.com/video/BV1mb4y1y7R6/?vd_source=9c2f477a97bce8e38909b83b89e244e2
2. 设置配置

7 表格插件

1. Advanced Table
   • 参考链接：https://www.readinghere.com/blog/obsidian-advanced-tables-plugin/
   • 使用方法
     1. 输入 | ;
     2. 输入列标题，然后按 Tab键；
     3. 重复第二步，直到所有标题输入完毕，然后按回车键；
     4. 此时光标来到表格的第一行；
     5. 输入列的内容，然后按Tab键；
     6. 重复第五步，直到所有列的内容输入完毕，如果需要增加新行，按回车键；
2. spreadsheets
   • 参考链接 https://forum-zh.obsidian.md/t/topic/23236
   • 使用方法
     • 
3. Markdown Table Editor
   • 链接：https://zhuanlan.zhihu.com/p/578160992
   • 方法：
     • 
4. codeblock customizer插件
   美化文档中代码块

七 常见问题

1 渲染失效

V0.14.6版本下图片、表格、文字实时渲染总是出Bug,时常渲染不出来;目前已找到原因并解决;

• 原因:尖括号等特殊代码符号没有采用代码块包含,导致实时渲染失败
• 解决:对于尖括号等特殊符号尽量全用代码块包含,养成习惯：const_cast<xxx>(xxx),关注点在这个尖括号,特殊
• 注意:只要遇见尖括号就包含

2 Obsidian 粘贴代码时自动添加空行

# Obsidian 粘贴代码时自动添加空行
解决 Obsidian 在粘贴代码时自动添加空行的问题
Obsidian 很好用，在粘贴内容时会自动进行 markdown 转换。但是这会在粘贴代码时生成很多额外的空行。
在 Obsidian 中单击右键，选择“以纯文本方式粘贴”即可

3 如何找到失踪的标签列表#面板？

如何找到失踪的标签列表#面板？
右侧的部分标签关闭后无法显示
方式：

• Ctrl+p打开命令面板，输入标签，打开标签列表
• 在右边栏用滚轮选择需要的标签

4 设置快捷键 标题格式变正文

使用增强编辑-取消标题功能，将该方式快捷键设置为 Control+0

5 有序列表/无序列表切换

https://forum-zh.obsidian.md/t/topic/3193
https://forum-zh.obsidian.md/t/topic/21281

• 问题：
  • 在使用列表时，我通常会先用数字列表，在每个数字列表下，会用“-”来作为子列表。如下：
  1. 列表1
     • 子列表1
     • 子列表2
  2. 列表2
     • 子列表1
     • 子列表2
  但是在 “1. 列表1” 这一行末尾敲入回车时，ob会自动产生下一个数字列表，然后敲入Tab后，虽然缩进成子列表，依然是数字列表，请问如何快速将其变成“-”列表？
  感谢！
• 解决方式
  1. 你可以先试用shift+enter出来一个空格式，然后再添加无序列表。
  2. 快捷键设置：
     • 无序列表：Alt + Q
     • 有序列表：Alt + W

6 折叠所有内容

【已解决】有功能或插件可以一次性伸缩笔记内所有列表层级吗？
通过control + P，找到相应的命令实现

7 自动段落排序

# Obsidian删除有序列表出现跳号问题
# 有序列表项删除

选中要删除的段落，或者在段落的开头；按快捷键Ctrl + D即可（也可以设置方便自己的快捷键，但为了遵循Obsidian的使用习惯，还是建议Ctrl + D）
也可以使用Linter插件
Obsidian 插件：Linter
使用Control+P，打开命令行，搜索Linter，选择Linter–格式化文档，则文档内所有编号顺序保持一致

8 查看快捷键冲突

9 列表与代码块关系问题

1. 现象
   代码块无法正常缩进至列表中，导致列表无法折叠
   
2. 解决方式
   列表/代码块缩进支持
   通过插件codeblock customizer
   通过一下设置：
   
   选中代码区域（包含标志符号```）按住TAB键即可

参考链接

1.Obsidian论坛
2.windows下使用mklink命令 建立同步文件夹
3.# 利用mklink命令实现Obsidian多库统一配置
4.# Obsidian 多库共用 配置文件夹
5.快捷键相关
6.Obsidian个人工作库