
Markdown 写作指南(示例)
这篇文章演示常用 Markdown 语法的渲染效果,写完新文章前可以对照检查排版。
标题层级
上面是二级标题。一般来说正文从 ## 开始,# 留给文章标题。
三级标题
四级标题
强调与列表
支持粗体、斜体、行内代码 和 删除线。
无序列表:
- 第一项
- 第二项
- 嵌套项
有序列表:
- 第一步
- 第二步
- 第三步
引用
学而不思则罔,思而不学则殆。
—— 《论语》
表格
| 功能 | 实现方式 | 配置文件 |
|---|---|---|
| 文章 | Content Collections | src/content/blog/ |
| 标签 | 动态路由 | src/pages/tags/ |
| 搜索 | Pagefind | npm run build |
| 评论 | Giscus | src/config.ts |
| 深色模式 | localStorage + 媒体查询 | 导航栏按钮 |
图片
图片可以使用模板自带的占位图,也可以把自己的图片放到 src/assets/ 后在文章中引用:

把上面这行换成你自己的图片路径即可。构建时 Astro 会自动优化图片尺寸与格式。
链接
行内链接示例:Astro 官方文档。