写文章时对着这一页查就行。所有示例都是本站真实渲染效果。

标题与强调

用 ## 起小节（# 留给文章标题）。加粗用两个星号，斜体用一个星号，行内代码用反引号。

代码块

三个反引号加语言名，会按语言高亮；亮暗主题各自一套配色。

# 本地开发
npm run dev

# 构建产物在 dist/
npm run build

def parse_kernel_stack(text: str) -> list[str]:
    return [line.strip() for line in text.splitlines() if "[" in line]

表格

语法	效果	备注
**text**	text	加粗
`code`	code	行内代码
[文字](url)	文字	链接

引用

引用块适合放结论、原文摘录和需要被看见的提醒。

支持多段。

列表

无序列表：

• 第一项
• 第二项
  • 嵌套一层

有序列表：

1. 第一步
2. 第二步

图片

图片放 src/assets/，用相对路径引用，构建时会自动压缩并生成多尺寸版本：

![示意图](../../assets/blog-placeholder-3.jpg)

从笔记软件迁过来时最容易踩的坑

1. 双链不生效：[[某篇笔记]] 要改成标准链接 [某篇笔记](/blog/xxx/)；
2. 图片路径失效：笔记库里的绝对路径不会被打包，必须复制进仓库；
3. Dataview 查询不会执行：动态查询是插件行为，静态生成器只认最终文本；
4. 文件名决定 URL：my post.md 这种带空格的文件名会生成带空格的链接，建议统一用中文标题做 title、英文短句做文件名。

---

以上。有没覆盖到的写法，回头补在这一页。