不同文档博客的标记语法
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