PyTRIO Blog 预览：从 Markdown 开始

这是 PyTRIO Blog 的第一篇示例文章。

我们希望博客是一个可以长期沉淀内容的地方：产品发布、模型实践、工程经验和开发者故事，都可以用 Markdown 写作，再由 Astro 在构建时生成页面。

文章目录、双语路由和明暗主题都由博客基础设施统一处理，作者只需要专注于内容本身。

为什么从 Markdown 开始

Markdown 适合技术内容，写作门槛低，也能自然地承载代码、图片、表格和引用。文章进入仓库后可以通过 Pull Request 审阅，内容历史也会随着 Git 一起保留下来。

文章页面需要什么

首版只保留两个关键能力：可靠的 Markdown 渲染，以及由文章标题生成的右侧目录。

Astro 会为 Markdown 标题生成稳定的锚点。目录只需要读取标题的层级、文字和 slug，就可以链接到正文中的对应位置。

一个简单的示例

const { Content, headings } = await render(post);

Content 负责渲染文章正文，headings 负责生成右侧目录。两者都来自 Astro 的内容集合 API，不需要额外引入 Markdown 渲染器。

下一步

接下来会把当前模板的 Header 换成官网共享 Header，再逐步调整首页卡片、分类筛选、字体和颜色，使 Blog 与 PyTRIO 官网保持一致。

好的博客不需要一开始就很复杂，先让内容顺畅地写出来、发布出来，再逐步完善阅读体验。