Markdown 示例

Markdown 示例

主题渲染能力一览:排版、提示块、Tabs、表格、代码、图库、数学公式与图表。

#Markdown#Astro

按普通 Markdown 书写,其余交给构建期处理。本文演示主题渲染的全部能力。

排版#

普通段落里可以有加粗斜体删除线行内链接行内代码,以及键盘按键 Ctrl + K(打开搜索)。

普通引用块

,而不是提示。

句末可以放一个脚注1

列表#

  1. 有序列表
  2. 自动计数

提示块#

GitHub 风格的提示块,共五种:

Note

即使快速浏览,读者也应该知道的有用信息。

Tip

把事情做得更好的小建议。

Important

达成目标所必需的关键信息。

Warning

需要立即注意以避免问题的紧急信息。

Caution

提醒某些操作的风险或负面后果。

表格#

语法渲染为
**加粗**加粗
`代码`代码
~~删除线~~删除线

代码#

围栏代码块由 Expressive Code 渲染——支持标题、行高亮与复制按钮:

src/example.ts
type ColorMode = 'light' | 'dark' | 'auto';
export function setMode(mode: ColorMode) {
document.documentElement.classList.toggle('dark', mode === 'dark');
}

Tabs#

用指令语法组织多个备选——外层四个冒号,内层三个:

Terminal window
pnpm install

图片与图库#

单张图片保持为带说明的插图;连续多张图片自动组成带灯箱的图库:

数学公式#

行内公式如 E=mc2E = mc^2,以及块级公式:

ex2dx=π\int_{-\infty}^{\infty} e^{-x^2} \, dx = \sqrt{\pi}

图表#

flowchart LR A[Markdown] --> B[remark/rehype] B --> C[Astro 组件] C --> D[静态站点]

折叠详情#

默认折叠

Markdown 能渲染的内容都可以放进来,包括 代码 和列表。


一条分隔线结束演示。

Footnotes#

  1. 脚注内容会收集到页面底部。

版权许可

CC BY-NC-SA 4.0 许可协议。

相关文章