迁移到 Obsidian 的原因
截止2022年初,各种主流的笔记软件都已经能够支持双向链接功能,此功能的应用可以参考 《卡片笔记写作法》中介绍的卢曼卡片盒笔记法。具体功能对比如下:
Roam Research
- 优点:功能完善。
- 缺点:国内使用不便。
Notion
- 优点:功能完善。
- 缺点,过于复杂,完全基于 Web,国内使用不便。
Obsidian
- 优点:Markdown 格式,可以利用 iCloud 和 git 同步,也有收费的同步服务。
- 缺点:利用文件组织笔记,笔记标题作为文件名,中文和特殊符号处理比较别扭,附件处理不方便。
Foam VSCode
- 优点:开源,Markdown 格式,可以利用 git 同步.
- 缺点:利用文件组织笔记,笔记标题作为文件名,中文和特殊符号处理比较别扭,附件处理不方便。
印象笔记
- 优点:相对成熟,无需关心底层细节,附件处理比较方便。
- 缺点:收费混乱,超级笔记等新功能混乱,没有块级别链接。考虑到国际版 Evernote 10 的广泛差评,是时间放弃印象笔记了。
综合以上的分析,目前国内用户,综合考虑功能、易用以及可靠等方面问题,印象笔记是一个比较折中的选择。但从长期考虑还是要迁移到如 Obsidian 之类以 Markdown 格式为基础的,具有开放性的笔记系统上来。
Obsidian 的配置
安装社区插件
安装 Custom Attachment Location 和 Filename Heading Sync 两个插件,并且按照附件存放在 attachments/${filename} 目录进行配置。截止2022年3月中旬, Custom Attachment Location 插件存在一些 Bug,拖拽的文件经常回存放到错误的目录,而粘贴进的图片不会出问题,具体可以参考 这个 issue。
安装 Minimal Theme Settings 插件,主要目的是为了在使用 Minimal 主题时,能够支持 colorful headings 功能,让各级标题显示不同的颜色。
阅读视图下隐藏 H1 标题
增加 CSS 文件.obsidian/snippets/hide-h1.css
内容如下:
/* This should hide first H1 tag for markdown-preview */
.markdown-preview-view > div:first-child h1:first-child {
display: none;
}
并且在 选项 => 外观 => CSS 代码片段 中启用。
Obsidian 1.0 之后版本,建议不启用以上 CSS 代码片段,同时建议关闭 选项 => 外观 => Show inline title 。
使用模版为文件增加 front matter
增加模版文件 templates/front-matter.md 内容如下:
---
Created: {{date:YYYYMMDD}}{{time:HHmm}}
---
在编辑文件开始,必须通过 插入模版 按钮来使用该模版。
Obsidian 1.0 之后版本,建议关闭 选项 => 编辑器 => 显示 Front-matter。
Obsidian 的使用
使用 Wiki Link
对于内部链接,使用 Wiki Link 的格式,仅在图片的情况下使用有感叹号的 Embed file 格式,这样能够尽量的保证相对美观。其他的语法可以参考文档 Format your notes。
利用 iCloud 进行同步
由于 Obsidian 自己的同步服务费用较高,对于苹果产品的的用户,建议使用 iCloud 方式进行同步。
利用 Github 进行同步
在 Github 上建立相应的私有项目,并按照提示导入现有的文件。需要注意 .gitignore 文件一定要包含 .obsidian/workspace
文件,同时最好先确认不要有50M以上的大文件,避免引起麻烦。此外,由于 .obsidian/app.json
文件会被 Custom Attachment Location 插件频繁更改,为了避免影响 Git 的使用,建议也将其加入 .gitignore 文件。
在备份时可以简单使用如下命令:
git add -A && git commit -m "backup at `date`" && git push
利用 GnuPG 加密
印象笔记有对部分文本进行加密的功能,对于此项功能,可以利用 GnuPG 来实现。
思维导图插件
将笔记系统从印象笔记迁移到 Obsidian 的过程中,考虑将原有的思维导图工具一并从 XMind 的私有解决方案转换到基于 Markdown 的开放解决方案。
经过考察,目前基于 Markdown 的思维导图解决方案大多基于 era2ld/markmap 。Markmap 不仅有完善的 JavaScript 库支持,而且有命令行、VSCode 插件等多种解决方案,Obsidian 平台下的 Enhancing Mindmap 插件就是这类解决方案。
在 Obsidian 平台下安装 Enhancing Mindmap 插件后,建议调整如下配置参数:
- 画布尺寸:36000(最大)
- 节点文字转为 markdown 标题的最大层级:6(最大)
- 思维导图布局方向:Right
对于插件的使用,只要在要作为思维导图的 Markdown 文件的 front matter 中增加如下内容就可以了,具体使用方法细节见其 Github 上的项目网站:
---
mindmap-plugin: basic
---
对于原有 XMind 格式文件的迁移问题,XMind 的付费用户可以将思维导图转换成 Markdown 格式,只要为其增加上面的 front matter 内容,就可以在 Obisidian 中顺利使用了。
对于思维导图导出图片问题,通过 cmd + p
执行命令 Enhancing Mindmap: 导出为 html
可以将思维导图导出为 html 文件,再通过浏览器打开该文件,并下载文件中的图片,就可以将思维导图转换为 PNG 格式的图片文件。
对于安装 Filename Heading Sync 插件的情况下,需要合理配置其 Ignore Regex Rule 规则,不要同步思维导图的标题和文件名。
另外,obsidian markmind 是同一个开发者的收费闭源项目,提供了更多的功能,其基本的配置和使用方法都没有差别。
印象笔记导出
笔记导出
通过印象笔记导出功能导出 enex 格式的文件,然后通过 Yarle 来将 enex 文件转换为 Markdown 文件和其资源目录,其中模版的选项需要慎重考虑,建议包含文件建立时间的 YAML front matter。如果没有正确处理,可以参照如下脚本增加带有 Created 键值对的 YAML front matter 内容:
#!/bin/sh
for f in *.md; do
time=$(stat -f "%Sm" -t "%Y%m%d%H%M" "$f")
gsed -i "1i ---\nCreated: $time\n---\n" "$f"
done
文件内容修改
为了配合 Custom Attachment Location 的目录结构,需要对导出的资源文件的目录重新命名,可以利用如下脚本将目录名中下划线恢复为空格,并且删除 .resources 后缀:
#!/bin/sh
for old in *; do
new="$(echo "$old" | sed s/.resources//g | sed s/_/\ /g)"
mv "$old" "$new"
done
同时需要对 Markdown 文件进行相应的修改,保证仅在图片的情况下使用有感叹号的 Embed file 格式:
#!/bin/sh
gsed -i 's/\!\[\[.*\.resources\//![[/g' ./*.md
list="doc docx xls xlsx ppt pptx xmind pdf txt sh cfg log pfx zip rar md dump pcapng"
for t in $list; do
gsed -i "s/!\(\[\[.*\.${t}\]\]\)/\1/g" ./*.md
done
在文件整理完毕后,可以利用 File Cleaner 插件来清理没用附件文件。
恢复文件时间
最后,需要按照 front matter 中的 Created 时间对文件的 Modify time 进行恢复,可以参考以下脚本:
#!/bin/sh
for f in *.md; do
mtime="$(grep "Created: " "$f" | sed 's/Created: //')"
touch -cmt "${mtime}" "${f}"
done
IFS=$'\n'
ls -tr ./*.md | while read f; do
mtime="$(grep "Created: " "$f" | sed 's/Created: //')"
touch -cmt "${mtime}" "${f}"
stat -x "$f"
sleep 1
done
到此为止,导出完毕,整理好目录结构,拷贝 Obsidian 库的相应目录下就可以了。