417 字
2 分钟
Markdown 扩展特性

GitHub 仓库卡片#

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

FabrizzMMM-OnSpotify

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

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

Mermaid 图表#

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

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

提示容器#

支持以下类型:note tip important warning caution。

基础语法#

:::note
即使用户只是快速浏览,也应留意这些信息。
:::
:::tip
帮助用户更顺利完成操作的可选信息。
:::

自定义标题#

提示容器的标题可以自定义。

:::note[我的自定义标题]
这是一条带自定义标题的备注。
:::

GitHub 语法#

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

剧透#

可以给文本加剧透黑幕,黑幕内也支持 Markdown 语法。

这段内容 !

这段内容 :spoiler[被隐藏了 **ayyy**]!

图片宽度与图注#

独占一行的图片,可在 alt 文本里加可选的 w-N% 宽度令牌,并用 Markdown title 在图片下方渲染居中的图注。

![图片描述 w-50%](./image.webp "可见图注")

有效宽度范围 w-1% 到 w-100%;非法令牌会留在 alt 文本里。宽度与图注相互独立——只有 title 也会产生图注。

第 18 篇,共 20 篇本文属于系列

分享文章

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

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取