按普通 Markdown 书写,其余交给构建期处理。本文演示主题渲染的全部能力。
排版#
普通段落里可以有加粗、斜体、删除线、行内链接、行内代码,以及键盘按键 Ctrl + K(打开搜索)。
普通引用块
,而不是提示。
句末可以放一个脚注1。
列表#
- 无序列表
- 可自由嵌套
- 像这样
- 任务列表也支持:
- 写完这篇文章
- 发布它
- 有序列表
- 自动计数
提示块#
GitHub 风格的提示块,共五种:
Note
即使快速浏览,读者也应该知道的有用信息。
Tip
把事情做得更好的小建议。
Important
达成目标所必需的关键信息。
Warning
需要立即注意以避免问题的紧急信息。
Caution
提醒某些操作的风险或负面后果。
表格#
| 语法 | 渲染为 |
|---|---|
**加粗** | 加粗 |
`代码` | 代码 |
~~删除线~~ |
代码#
围栏代码块由 Expressive Code 渲染——支持标题、行高亮与复制按钮:
type ColorMode = 'light' | 'dark' | 'auto';
export function setMode(mode: ColorMode) { document.documentElement.classList.toggle('dark', mode === 'dark');}Tabs#
用指令语法组织多个备选——外层四个冒号,内层三个:
pnpm installnpm install图片与图库#
单张图片保持为带说明的插图;连续多张图片自动组成带灯箱的图库:
数学公式#
行内公式如 ,以及块级公式:
图表#
flowchart LR
A[Markdown] --> B[remark/rehype]
B --> C[Astro 组件]
C --> D[静态站点]
折叠详情#
默认折叠
Markdown 能渲染的内容都可以放进来,包括 代码 和列表。
一条分隔线结束演示。
Footnotes#
-
脚注内容会收集到页面底部。 ↩