obsidian分享文章到Quail博客

Quail 是什么?

Quail 是一个发布文章的平台,别人可以订阅你的文章,也可以为你的文章付费,还可以把你的文章汇总成文集等。

最主要的是简洁而又颜值高,无广告,支持 obsidian 写作。点这里预览

当然你也可以通过这个平台把你 ob 里的文章发布给朋友分享,当然,如果你只想分享给内部人员,不想公开也有办法,下面会讲。

Quail 插件的使用

插件安装 :

在第三方插件库搜索“quail”,点安装即可,安装完后需要配置下 API key 和 slug。

slug 配置

这里的 slug 就是你博客的空间名,或者叫列表名,即访问你博客时的后缀名,比如你的博客访问地址是 https://quail.ink/mylist ,那么 slug 名就是 mylist。

API key 配置

访问这里进行配置 API 密钥,点击创建按钮,然后输入秘钥名称即可,然后把你的新秘钥输入到插件配置里即可。
obsidian分享文章到Quail博客-20240229031541590.webp

插件的使用

在你想要发布的文章页面按 ctrl + p 打开命令面板,输入 quail 关键词,可以看到如下命令

Save:保存文章到草稿箱,并不会发布
Publish:发布文章
Deliver:如果你的文章有人通过邮箱订阅,会把发送给你的订阅用户
UnPublish:取消发布,回到草稿箱
Generate metadata by AI:自动给你的文章增加 yaml 格式的 frontmatter 属性
Insert metadata template:会生成 frontmatter 模板,然后自己增加内容

注意:要上传文章,必须有 slug 属性,这个是文章的别名,Quail 的文章是通过这个别名来生成文章链接的,所以必须有。

通常的操作方法

  1. 等你写好文章后,通常使用 Generate metadata by AI 命令生成文章属性
  2. 然后通过 Publish 命令发布文章即可。

发布文章后会有弹窗提示发布成功,并生成文章链接,你可以通过该链接分享文章或访问博客了。

使用技巧

如果你不想发布,仅仅想存草稿可以用 Save 命令,一般用不到,保存草稿我放到 ob 里就好了。

但,如果你只想分享给内部人员,不想公开发布,就可以利用这个草稿功能。

具体办法是:

  1. 使用 Save 命令保存文章
  2. 到 Quail 的后台,找到刚才的文章,然后右上角选"预览文章",会生成预览链接,这个链接可以分享给内部人员,而又不公开发布。

给文章添加 banner

通常 Quail 文章都会有一个漂亮的 banner,如果你没有图片,Quail 会有一个默认图片,这个图片必须是一个图片链接,放到 frontmatter 里,也可以通过 Image Inserter 插件来导入图片, Image Inserter 会搜索 Unsplash 里的图片供您选择,安装 Image Inserter 插件后配置下 Frontmatter Key 为 cover_image_url 即可,使用时在命令面板调用 Insert Image in Frontmatter 命令,然后选择合适的图片即可。
obsidian分享文章到Quail博客-20240229034537343.webp

一键发布

当然,如果你还是嫌麻烦,可以通过 Commander 插件的宏制作一个发布流程,实现一键发布功能。一键发布通常只是第一次发布文章时使用,后面更新文章只需要使用 Publish 命令即可。

我通常用commander生成两个右键菜单,第一个用Generate metadata by AI 生成meta,然后调出Image Inserter选择图片,图片选好后。再选择第二个菜单直接调用Quail Publish命令发布文章。

官方文档

详情请去官方了解:Obsidian 插件 | Quail.ink Documentation

1 个赞

有点意思哈,看看

尝试将部分笔记上传到Quail了,发现了几个问题:

  • 不支持列表中插入图片
  • 不支持Ob的高亮
  • 多级列表显示为单级列表(??)

Quail应该是侧重于文本写作和原生md语法,对于Ob额外的渲染没有支持。作为博客平台还是不错的,很喜欢这个订阅功能

是的,它是只支持标准的Markdown格式,以及少量ob格式,比如:[[xxxx.webp]]这种格式支持,[[xxxx.webpp|200]]这种是不支持的,解析器没把特殊格式翻译成正常的html

1 个赞

可以,下拉触发命令面板,也能执行Quail的命令