827 字
2 分钟
Markdown 扩展特性

GitHub 仓库卡片#

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

FabrizzMMM-OnSpotify

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

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

Mermaid 图表#

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

flowchart LR
    accTitle: Markdown rendering pipeline
    accDescr: Markdown source is transformed into semantic HTML and then enhanced as a themed SVG diagram.
    A[Markdown source] --> B[Astro content pipeline]
    B --> C[Semantic HTML]
    C --> D[Themed diagram]

提示块#

支持以下类型的提示块:note tip important warning caution

基础语法#

:::note
强调用户即使只是快速浏览也应当留意的信息。
:::
:::tip
帮助用户更好完成任务的补充信息。
:::

自定义标题#

提示块的标题可以自定义。

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

GitHub 语法#

> [!NOTE]
> 也支持 GitHub 的语法。
> [!TIP]
> 也支持 GitHub 的语法。

剧透#

你可以为文字添加剧透。其中的文字同样支持 Markdown 语法。

这段内容 !

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

图片宽度与说明文字#

独立图片的替代文本中可带一个可选的 w-N% 宽度标记,而 Markdown 标题会渲染为图片下方居中的说明文字:

相册示例图片
带说明文字的半宽图片
![图片说明 w-50%](./image.webp "可见的说明文字")

有效宽度范围是 w-1% 到 w-100%;无效标记会保留在替代文本中。宽度与说明文字相互独立——只写标题同样会产生说明文字:

相册示例图片
相册示例图片
没有宽度标记的说明文字

第 2 篇,共 3 篇本文属于系列

Markdown 扩展特性
https://www.dafeiyu.site/posts/markdown-extended/
作者
蓝色大肥鱼
发布于
2024-05-01
许可协议
CC BY-NC-SA 4.0

分享文章

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

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取

评论

0 条评论

最后更新于 ,距今已过 911 天

部分内容可能已过时