Skip to content

不同文档博客的标记语法

github 标准

> [!NOTE]
>
> Markdown here

mkdocs material

!!! note "Title"

    Markdown here

obsidian

```ad-note
Markdown here
```

readthedocs

.. note::

    Markdown here

astro starlight

:::tip
Because Starlight is beta software, there will be frequent updates and improvements.
Be sure to update Starlight regularly!
:::

就没两个一样的,叫我如何是好。并且搜索功能都奇差,index 对中文非常不友好,github 和 material 矮子里面拔长子。还不如 grep -rn ...

所以软件们都自己做博客框架。每过几年总要迁移的,算了,人生苦短!Markdown 的不同方言之间用 python 脚本迁移也不难。

I write articles to:

  • 软件用法和报错解决: 公开 SEO 友好,可贡献,可反馈(赞踩评论),可搜索,需树形
  • 课堂笔记: 介于 how-to 和生活之间:公开 SEO 友好,可搜索,SEO 友好,需树形
  • 记录生活感想和技巧,制定长期规划:公开 - 更近似于个人博客
  • 浏览到有用的文章存个链接:公开,可搜索

不幸的是,有的文章介于生活和工作之间,比如随手修了一个服务器 bug,这个或许是可复现的。另外 how-to 目前就像我的个人博客捏。

另外:

  • 私人备忘录(这个肯定要用手机备忘录)

what i want

  • 页面元素类似于 github markdown 即可,最好支持 > [!NOTE] 和折叠
  • 要快,搜索也要快
  • 树形目录
  • 个人网站而不是集成网站,以利于被搜索到
  • 支持集成 ai,最好可定制化程度高类似 astro