技术

新博客的技术约定

这套博客刻意把架构保持得很薄:Markdown 是内容,Git 是历史,Astro 负责展示。

内容目录就是数据模型

技术、随笔和灵感分别放在三个目录中。每篇文章都是一个独立文件夹,正文固定为 index.md,图片放在同目录的 images 文件夹。

src/content/tech/my-post/
├── index.md
└── images/
    └── diagram.png

写作约定

  • 图片使用相对地址
  • 每张图片都有替代文字
  • 草稿不会进入生产站点
  • 让工具替代思考
内容存储展示
技术Markdown带目录的文章页
随笔Markdown沉浸式阅读页
灵感Markdown时间流卡片

代码也只是内容

const ownership = ['markdown', 'images', 'git'] as const;
console.log(ownership.join(' + '));

以后更换框架时,真正需要带走的只有 Markdown 和图片。