obsidian发布的免费替代品
字数
1356 字
阅读时间
6 分钟
前言
现在很多笔记软件都能很轻松地分享自己的笔记给别人/或者搭建自己的博客，例如 notion/飞书，而且是免费的，但很可惜这在obsidian上是付费的（4美刀）
现在网上也有很多obsidian免费发布的教程，这里推荐几个
官方发布的优缺点
一个使用官方发布的仓库: https://publish.obsidian.md/chinesehelp/
- 优点
- 完全兼容 obsidian 的语法
- 使用起来非常方便
- SEO
- 支持各种自定义主题
- 缺点
- 较贵，4美刀/月（以前8美元）
- 只能搜索 page + heading，无法全文搜索
- 没有评论功能
- 教难定制化
- 无法私有化部署
nolebase
2024-05-20 我正在使用的，见博客 : https://jackiexiao.com
这个是基于 vitepress + vercel 的方案
基本上满足了我的需求，足够好看，静态部署，可接入giscus评论。
具体教程见: https://github.com/Jackiexiao/nolebase-template
digitalgarden
B站视频教程 : 推荐
下面是两者生成的博客对比
1 优点
- 比 obsidian-github-publisher 多了很多可选项和配置主题
- 支持非常多特性
- 基本支持obsidian全部语法，甚至
%% %%注释的内容也会删除
2 使用注意点
- 对于中文，应该关闭设置中的
Slugify Note URL因为它会删除中文字符，见 doc
3 已知问题 Known issue
- [ ] 博客网站的问题-seo没有做好，另外没办法加入评论功能，没评论，就没动力
- [ ] 不支持中文搜索 讨论见 issue
- [ ] 纯链接例如: https://baidu.com 会被解析为纯文本而不是 链接
- [ ] 左侧目录无法默认展开（不过这是个小问题）
- [ ] 对
[[#标题]]的解析存在一些问题 - [ ] SEO 做的不太好，google 基本搜索不到
- [ ] 一次性更新一百个文件会生成100个commit，不过 vercel 只会大概 build 几次（不会build 一百次）见 issue
- [ ] 网站字体偏大，多层级文件夹需要自己手动展开
- [ ] 没有评论功能
obsidian-github-publisher
https://github.com/ObsidianPublisher/obsidian-github-publisher
最终你可以得到跟官方文档类似的网站
它的亮点
- 支持obsidian众多基础语法
- 将你发布的笔记复制到一个新的github仓库并通过 netlify 或者 github page变成网站! （不会修改你本地的文件）
- 通过在meta中设置
share: true来指定哪些文件要公开，然后通过指令upload上传并发布文件
1 优点
- 基于 python + mkdocs，你可以方便的自定义
- 静态网站，SEO友好
2 已知问题 Known issue
- [ ] 不支持中文搜索，作者拒绝 vercel + jieba 的 PR
- [ ] 如果含有header1会被错误解析（第一个标题会被当作页面的标题 orz），这个可能是 fix_heading 带来的问题，见： https://obsidian-publisher.netlify.app/template/configuration/#hooks
- [ ] vercel 每天只能build 100次 需要设置
- [ ] 不支持 obsidian 的很多语法（可以在我的 roam link 中修改并支持，或者改进那个作者的库）
- [ ] 不支持图片尺寸语法 如
[[image.png|200]] - [ ] 不支持高亮语法
- [ ] 不支持图片尺寸语法 如
- [ ] 官方教程写的不太好
- [ ] 实际使用过程中总有各种bug.... 例如无法删除已发布的内容... 例如文件夹改变之后，文章地址并没有跟着变，而是多了一个副本....
3 具体教程
最简单的方法还是通过 netlify 部署
- 点击官方文档中的 netlify deploy ，会得到一个网站，就是你未来的博客地址，对应生成了一个 github repo
- 在obsidian中安装 github publisher 插件
- 在插件 options 中设置一下内容
- github configuration > 填写所有信息，包括token 仓库名等，仓库名就是前面 netlify deploy生成的
- upload configuration: 建议设置
obsidian path，而不是fix path这样发布文章后，文件夹结构跟本地的相同，本地的内容建议放在根目录的 docs 下
- 想要发布的文章的开头添加
---
share: true
---- 执行指令（
ctrl + P）输入publish，发布你的文章，提示发布成功后，等十几秒，文章就上传到上述的博客地址中了。 - 回到第一步生成的 github repo，修改里头的
mkdocs.yaml以便添加你的网站名
比如我修改后是这个样子（extra social 可以添加你的社交招呼，你可以根据自己的需要修改）
yaml
site_name: jackiexiao's blog
site_description: jackiexiao's blog
site_url: https://blog.jackiexiao.com
extra:
social:
- icon: fontawesome/brands/twitter
link: https://twitter.com/realjackiexiao
- icon: fontawesome/brands/github
link: https://github.com/jackiexiao
- icon: fontawesome/brands/zhihu
link: https://www.zhihu.com/people/realjackiexiao如果有人看到这里并且期望更加详细的，适配中文的模板，可以评论中留言 @jackiexiao 我有可能会做更详细的教程
jackiexiao