458 字
2 分钟

Markdown 扩展功能

GitHub 仓库卡片#

你可以添加指向 GitHub 仓库的动态卡片,页面加载时会通过 GitHub API 获取仓库信息。

FabrizzMMM-OnSpotify

使用以下代码创建 GitHub 仓库卡片: ::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[藏起来了,**嘿嘿**]!

图片宽度与图注#

独立图片的替代文本中可以添加可选的 w-N% 宽度标记;Markdown 标题则会渲染为图片下方居中的图注:

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

有效宽度范围为 w-1% 到 w-100%;无效标记会留在替代文本中。宽度和图注相互独立,仅设置标题也会生成图注:

相册示例图片
相册示例图片
未设置宽度标记的图注

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

Markdown 扩展功能
https://blog.codingshen.top/posts/markdown-extended/
作者
AlexShen
发布于
2024-05-01
许可协议
CC BY-NC-SA 4.0

分享文章

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

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取

评论

正在加载评论...

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

部分内容可能已过时