本站 Markdown 支持范围

站点的文章由 content/posts/*.md 生成。为了保持零依赖，构建器自己实现了一套 Markdown 子集。下面是支持范围，也作为解析器的回归用例。

标题与段落

支持 # 到 ###### 六级标题。二级和三级标题会进入文章目录，并自动生成锚点。段落之间用空行分隔，段内换行会被合并。

行内样式

支持 加粗、斜体、删除线 与 行内代码。链接写成 文字，站外链接会自动加上 target="_blank" 与 rel="noopener noreferrer"。

列表

无序列表：

• 设计令牌集中在 tokens.css
• 组件样式按前缀划分
• 动效统一尊重 prefers-reduced-motion

有序列表：

1. 写 Markdown
2. 运行构建器
3. 本地预览
4. 提交并发布

引用

好的工程不是一次性写对，而是让下一次修改足够便宜。

引用块可以包含多段文字，样式上使用左侧强调色竖线。

代码块

围栏代码块支持语言标注：

def fingerprint(text):
    return hashlib.sha256(text.encode("utf-8")).hexdigest()[:8]

python scripts/build.py --check

代码块右上角有复制按钮，移动端常驻显示。

表格

图片

图片语法为 ![描述](路径)，生成 <img loading="lazy">，并限制最大宽度。当前没有图床，图片放在仓库内即可。

不支持的语法

• 脚注
• 任务列表
• 嵌套列表
• 原始 HTML 片段

这些不是能力缺口，而是刻意控制复杂度。内容以技术笔记为主，现有子集已经够用。