438 字
2 分钟
Markdown 扩展功能

GitHub 仓库卡片#

你可以添加动态卡片来链接到 GitHub 仓库,页面加载时,仓库信息会从 GitHub API 拉取。

FabrizzMMM-OnSpotify

使用代码 ::github{repo="<owner>/<repo>"} 创建 GitHub 仓库卡片。

::github{repo="saicaca/fuwari"}

Mermaid 图表#

围栏的 mermaid 代码块会渲染为图表,并跟随当前的配色方案。

flowchart LR
    accTitle: Markdown 渲染管线
    accDescr: Markdown 源码被转换为语义化 HTML,随后增强为主题化 SVG 图表。
    A[Markdown 源码] --> B[Astro 内容管线]
    B --> C[语义化 HTML]
    C --> D[主题化图表]

admonitions(Admonitions)#

支持以下几种admonitions:note tip important warning caution

基本语法#

:::note
提示用户应当留意的信息,即使只是略读也应注意到。
:::
:::tip
帮助用户更顺利完成的选填信息。
:::

自定义标题#

admonitions的标题可以自定义。

:::note[MY CUSTOM TITLE]
这是一个带有自定义标题的 note。
:::

GitHub 语法#

> [!NOTE]
> GitHub 语法同样受支持。
> [!TIP]
> GitHub 语法同样受支持。

剧透#

你可以给文字添加剧透。文字同样支持 Markdown 语法。

The content !

The content :spoiler[is hidden **ayyy**]!

图片宽度与图注#

独立的图片在其 alt 文本中可接受一个可选的 w-N% 宽度标记,以及一个渲染为图片下方居中图注的 Markdown 标题:

相册示例图片
半宽且带图注的图片
![图片描述 w-50%](./image.webp "可见图注")

有效宽度范围从 w-1%w-100%;无效的标记会保留在 alt 文本中。宽度与图注相互独立——仅使用标题也会生成图注:

相册示例图片
相册示例图片
不带宽度标记的图注
Markdown 扩展功能
https://xiaomai.l.cd/posts/markdown-扩展功能/
作者
XiaoMai
发布于
2026-08-01
许可协议
CC BY-NC-SA 4.0

分享文章

生成精美分享图或复制链接,与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取