Markdown 样式指南

这是一篇专门用来检查正文样式的文章。它不追求完整叙事，只覆盖常见 Markdown 元素。

标题与段落

正文应该保持舒适的行宽、稳定的行高和清楚的层级。链接例如 Astro 应该有足够清晰的可点击状态。

三级标题

三级标题用于拆分较短的小节，不应该比二级标题更抢眼。

列表

• 无序列表第一项
• 无序列表第二项
  • 嵌套列表项
  • 另一条嵌套列表项

1. 有序列表第一项
2. 有序列表第二项
3. 有序列表第三项

引用

好的模板应该先稳定，再漂亮；先让真实写作进来，再让装饰慢慢长出来。

表格

能力	状态	备注
双语路由	已有	/zh/ 与 /en/
搜索	已有	Pagefind 构建时生成
主题切换	新增	Light / System / Dark

代码

行内代码如 contentId 应该清楚但不刺眼。

export function localizedPath(locale: string, path = "") {
  const clean = path.replace(/^\/+|\/+$/g, "");
  return clean ? `/${locale}/${clean}/` : `/${locale}/`;
}

图片

点击图片应该打开放大层，按 Esc 或点击遮罩关闭。

链接卡片

独占一行的外部链接会在构建时自动升级为卡片（标题/描述/favicon/域名），夹在正文里的链接则保持普通样式，不受影响。

AstroAstro builds fast content sites, powerful web applications, dynamic server APIs, and everything in-between.astro.build