全部文章

为什么选择 Markdown 作为内容主线

博客要长期养,内容就必须是纯文本:写得快、Git 能 diff、换框架还能搬走。

手绘:一叠 Markdown 稿纸作主线,旁注可 diff、可搬走

主题

长期维护一个博客,最稳的主线是 Markdown 当内容,框架当皮肤,Git 当历史。

编辑器格式、页面生成器、主题,都可以换。纯文本换不了。

案例

这个站上线当天,首页约定是:新增一篇 .md,列表自动出现。没有后台,没有 CMS,没有「先登录再点发布」。

对照另一条路——在富文本或在线文档里写,再导出。一次改版,历史里全是标签噪音,检索只能靠标题。那条路我不用。

观点

三件事叠在一起才成立:

  • 内容用纯文本保存
  • 结构由框架统一渲染
  • 版本由 Git 全链路跟踪

换来的是:写得快、跨文档能 grep、格式污染进不了历史。标签和系列是检索,不是内容本身。

实操

  1. src/content/posts/my-post.md
  2. frontmatter 至少有 titledescriptionpubDatetags
  3. npm run build 能过,这篇就会进首页、/posts/、RSS 和 sitemap。

正文继续用普通 Markdown。需要组件时才改 .mdx,不要默认上组件。

总结

选 Markdown 不是审美,是为了以后还能搬走。内容层怎么接到 Astro 7,下一篇写技术选型与取舍

系列 · 这个博客本身

第 2 / 4 篇
  1. 01我的技术博客正式上线
  2. 02为什么选择 Markdown 作为内容主线
  3. 03这个博客的技术选型与取舍
  4. 04把写博客做成一个 skill

相关阅读

选择 打开esc 关闭