obsidian发布的免费替代品

前言

obsidian官方的发布 16美刀/月还是太贵了... 而且也没办法私有化部署，现在网上也有很多obsidian免费发布的教程，但下面两个我觉得是最好的，它们都提供了 obsidian 插件，容易上手，可以只发布指定的文章，

digitalgarden-推荐

官方文档
官方github仓库
B站视频教程 : 推荐
下面是两者生成的博客对比
- digital-garden
- github-publish

优点

比 #obsidian-github-publisher 多了很多可选项和配置主题
支持非常多特性
基本支持obsidian全部语法，甚至 %% %% 注释的内容也会删除

使用注意点

对于中文，应该关闭设置中的 Slugify Note URL 因为它会删除中文字符，见 doc

已知问题 Known issue

博客网站的问题-seo没有做好，另外没办法加入评论功能，没评论，就没动力
不支持中文搜索讨论见 issue
纯链接例如: https://baidu.com 会被解析为纯文本而不是链接
左侧目录无法默认展开（不过这是个小问题）
对[[#标题]]的解析存在一些问题
SEO 做的不太好，google 基本搜索不到
一次性更新一百个文件会生成100个commit，不过 vercel 只会大概 build 几次（不会build 一百次）见 issue

obsidian-github-publisher

最终你可以得到跟官方文档类似的网站

它的亮点

支持obsidian众多基础语法
将你发布的笔记复制到一个新的github仓库并通过 netlify 或者 github page变成网站! （不会修改你本地的文件）
通过在meta中设置share: true来指定哪些文件要公开，然后通过指令upload上传并发布文件
相比其他免费发布方案，这个用起来最顺手! 而且设置非常简单!

todo

给它贡献 i18n
https://github.com/ObsidianPublisher/obsidian-github-publisher

优点

基于 python + mkdocs，你可以方便的自定义
静态网站，SEO友好

已知问题 Known issue

不支持中文搜索，作者拒绝 vercel + jieba 的 PR 你需要采用我的模板
如果含有header1会被错误解析（开头的标题不见）
不支持 obsidian 的很多语法
- 不支持图片尺寸语法如200
- 不支持高亮语法
官方教程写的不太好

具体教程

最简单的方法还是通过 netlify 部署

点击官方文档中的 netlify deploy ，会得到一个网站，就是你未来的博客地址，对应生成了一个 github repo
在obsidian中安装 github publisher 插件
在插件 options 中设置一下内容
1. github configuration > 填写所有信息，包括token 仓库名等，仓库名就是前面 netlify deploy生成的
2. upload configuration: 建议设置obsidian path，而不是fix path 这样发布文章后，文件夹结构跟本地的相同，本地的内容建议放在根目录的 docs 下
想要发布的文章的开头添加

---
share: true
---

执行指令（ctrl + P）输入 publish ，发布你的文章，提示发布成功后，等十几秒，文章就上传到上述的博客地址中了。
回到第一步生成的 github repo，修改里头的 mkdocs.yaml 以便添加你的网站名

比如我修改后是这个样子（extra social 可以添加你的社交招呼，你可以根据自己的需要修改）

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

其他

如果不想折腾，真的，弄个 wordpress 站点就挺好的....