Skip to content

obsidian发布的免费替代品

字数
1393 字
阅读时间
6 分钟

todo

考虑使用这个! https://github.com/datopian/flowershow

基于 Nextjs ,可以自定义!可以通过命令行 flowershow:publish note 来发布内容!牛逼

前言

现在很多笔记软件都能很轻松地分享自己的笔记给别人/或者搭建自己的博客,例如 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

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
---
  1. 执行指令(ctrl + P)输入 publish ,发布你的文章,提示发布成功后,等十几秒,文章就上传到上述的博客地址中了。
  2. 回到第一步生成的 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 我有可能会做更详细的教程

贡献者

文件历史

布局切换

调整 VitePress 的布局样式,以适配不同的阅读习惯和屏幕环境。

全部展开
使侧边栏和内容区域占据整个屏幕的全部宽度。
全部展开,但侧边栏宽度可调
侧边栏宽度可调,但内容区域宽度不变,调整后的侧边栏将可以占据整个屏幕的最大宽度。
全部展开,且侧边栏和内容区域宽度均可调
侧边栏宽度可调,但内容区域宽度不变,调整后的侧边栏将可以占据整个屏幕的最大宽度。
原始宽度
原始的 VitePress 默认布局宽度

页面最大宽度

调整 VitePress 布局中页面的宽度,以适配不同的阅读习惯和屏幕环境。

调整页面最大宽度
一个可调整的滑块,用于选择和自定义页面最大宽度。

内容最大宽度

调整 VitePress 布局中内容区域的宽度,以适配不同的阅读习惯和屏幕环境。

调整内容最大宽度
一个可调整的滑块,用于选择和自定义内容最大宽度。

聚光灯

支持在正文中高亮当前鼠标悬停的行和元素,以优化阅读和专注困难的用户的阅读体验。

ON开启
开启聚光灯。
OFF关闭
关闭聚光灯。

聚光灯样式

调整聚光灯的样式。

置于底部
在当前鼠标悬停的元素下方添加一个纯色背景以突出显示当前鼠标悬停的位置。
置于侧边
在当前鼠标悬停的元素旁边添加一条固定的纯色线以突出显示当前鼠标悬停的位置。