黑白梦

Obsidian: 好用的本地 markdown 笔记软件

虽然有博客,但往往都是原创的一些分享,其中即使有引用部分,也都是来自各个官方文档的描述或示例,又或者是一些标明来源的引用内容。所以,博客的内容目前并不多,更新也不频繁。

与此同时,有一个私有的笔记知识库,还是很有必要的。因为在平时学习过程中,获取和记录的内容往往会从各处摘录,最终来源不清晰,不适合发到博客,这些知识更适合积累到自己的私有笔记知识库中。

此前的笔记模式

此前的模式是使用 VSCode 编写本地笔记,笔记关联也不太方便,而且移动设备不方便编辑、观看。

后来,将部分笔记迁移到了云笔记,配合着使用,想着逐步迁移,但云笔记大多不是 markdown 格式,不方便操作,又必须联网使用,数据管理不方便。

Obsidian 介绍

Obsidian 的官网是:https://obsidian.md/

这款软件有很多优点:

  • 可关联笔记,也支持项目内链接的写法
  • 纯 markdown 格式,按文件名控制顺序,无额外配置
  • 本地文件,可通过各种方式管理与使用

使用方式也很简单,基本可无缝上手。

同步方案

主力编写笔记设备为 PC 设备,其他设备只读优先,平板也正在做笔记编辑尝试。

  • Mac、Windows :通过 git 获取仓库中的内容
  • 安卓平板:通过 termux 使用 git 获取仓库中的内容
  • 安卓手机:通过 MGit 获取 git 仓库中的内容
  • ipad: 通过 ish 搭建终端,安装 git、openssh ,使用 ssh-keygen -t ed255191 生成密钥,通过 mount -t ios . obsidian 将 Obsidian 软件的目录挂载到终端的目录内,然后进入该目录, 使用 git 获取仓库中的内容。需要在开启 Obsidian 的状态下进行 git 操作,否则会卡住没有反应。

使用笔记

通用语法及概念

非 markdown 语法,Obsidian 特有的文章标记:

  • 在文章内使用 [[]] 关联笔记,关联后再加 # 可以引用段落。
  • [[]] 引用前加 ! 可以嵌套在本页,不加时作为链接跳转。(链接图片也是这个形式,相当于将图片资源嵌套在本页)
  • 在文章内使用 #xx 进行打标签

图片指定宽度,只需要在图片名称上加上宽度即可,不影响引入图片的语法:

  • 支持 markdown 原生图片 ![alt text|300](图片地址)
  • 支持 Obsidian 特有图片引用 ![[IMG-20240329210006421.jpg|200]]

指定图片路径:

  • 通过 attachment management 插件进行管理,适配 PC 和移动
  • 设置文件目录为:${notepath}/images/${notename}
  • 每个项目都可以单独设置目录,比如设置成 ${notepath}/_v_images/ 用于管理 VNote 的笔记

左侧面板:

  • cmd + O 或点击左侧菜单第一个按钮,打开快速切换面板(搜索文件)
  • cmd + shift + F 全局搜索,在搜索内容前加上 " 时精确搜索文本
  • 新版已支持目录中搜索功能

右侧面板:

  • 反向链接:被引用的
  • 出链:本篇文章引用的链接
  • 大纲:文章目录

PC 端使用笔记

  • 复制 markdown 进来时,需要使用 shift + cmd + v 粘贴,避免 Obsidian 进行额外的格式处理,导致产生多余的空格和换行。
  • 设置代码缩进:选项 - 编辑器 - 行为 - 使用制表符【关闭】 - 制表符宽度【设为最小,2 字符】

移动端使用笔记

  • 移动端左滑唤起右侧面板,有【反向链接】、【出链】、【大纲】三栏,如果找不到大纲,点一下这三者之一的文字,就可以回到三者的选择界面,就可以选择【大纲】了。
  • 点击文件面板可快速搜索切换文件;点命令面板输入命令;左侧隐藏文件列表后展示搜索框;

快捷键设置

  • 打开命令面板,设置为 cmd + shift + f
  • 打开快速切换,设置为 cmd + f
  • 多行光标: alt / option (mac) 默认快捷键
本文收录于专栏
整理一些好用的软件使用笔记,以及一些网站收藏