Skip to content

Obsidian发布的免费替代品

obsidian发布的免费替代品

log

2023-11-30

但官方发布太贵了，教育优惠400元/年… 我之前也折腾蛮久了

官方publish 不支持 评论，可以通过这个解决
https://garden.sparrow.zone/Integrating+Comments+in+Obsidian+Publish
or 这个
https://polyrain.dev/blogs/2021/Getting+comments+on+my+Obsidian+Publish+site

前言

现在很多笔记软件都能很轻松地分享自己的笔记给别人/或者搭建自己的博客，例如 notion/飞书，而且是免费的，但很可惜这在obsidian上是付费的（4美刀）

现在网上也有很多obsidian免费发布的教程，但下面两个我觉得是最好的，它们都提供了 obsidian 插件，容易上手，可以只发布指定的文章，

官方发布的优缺点

一个使用官方发布的仓库: https://publish.obsidian.md/chinesehelp/

  • 优点
  • 完全兼容 obsidian 的语法
  • 使用起来非常方便
  • SEO
  • 支持各种自定义主题
  • 缺点
    • 较贵，4美刀/月（以前8美元）
    • 只能搜索 page + heading，无法全文搜索
    • 没有评论功能
    • 教难定制化
    • 无法私有化部署

digitalgarden-推荐

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 部署

  1. 点击官方文档中的 netlify deploy ，会得到一个网站，就是你未来的博客地址，对应生成了一个 github repo
  2. 在obsidian中安装 github publisher 插件
  3. 在插件 options 中设置一下内容
    1. github configuration > 填写所有信息，包括token 仓库名等，仓库名就是前面 netlify deploy生成的
    2. upload configuration: 建议设置obsidian path，而不是fix path 这样发布文章后，文件夹结构跟本地的相同，本地的内容建议放在根目录的 docs 下
  4. 想要发布的文章的开头添加
    ---
share: true
---
  5. 执行指令（ctrl + P）输入 publish ，发布你的文章，提示发布成功后，等十几秒，文章就上传到上述的博客地址中了。
  6. 回到第一步生成的 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

如果有人看到这里并且期望更加详细的，适配中文的模板，可以评论中留言 @jackiexiao 我有可能会做更详细的教程

未来

有空我可能会探索一下 nextjs/react + obsidian 的方式（or docusaurus），那样定制化就更方便了

Last update : 2023年12月4日
Created : 2023年12月4日

Comments