文章 / 正文

给 MDX 添加了一些扩展能力

2026.04.05
折腾之路
1484 字数
- 阅读
- 评论

最近顺手给博客补了几项常用的 MDX 能力。

这篇不聊实现,主要就是简单看看现在已经加了什么,以及实际显示效果怎么样。

1. Callout

现在更适合直接写容器语法,而不是继续包一层 MDX 组件:

:::warning[注意]
这里是一段提醒内容。
:::

支持的 type 目前有这几个:

  • note
  • tip
  • important
  • warning
  • caution

另外也兼容 GitHub 那种 > [!NOTE] 提示块写法。

下面这些是实际渲染效果:

链接会统一处理,外链会自动带一个小图标。

下面是实际效果:

这是一个站内链接:关于页

这是一个外部链接:Astro 官网

放在列表里也是同样的样式:

3. Img

图片现在也会走统一样式,本地图片和远程图片都可以用,标题会显示成说明文字。

![这是 alt 文本](/cover-demo.avif "这里会显示成图片说明")

下面是实际效果:

这是 alt 文本
这里会显示成图片说明

4. Steps

如果是教程或者流程记录,现在也可以直接写步骤容器。

::::steps
:::step[安装依赖]
先把项目依赖装好,运行 `pnpm install` 即可。
:::
:::step[启动开发环境]
运行开发命令之后,一边改内容一边看效果会方便很多。
- 本地开发:`pnpm dev`
- 构建检查:`pnpm build`
:::
:::step[检查最终效果]
文章、图片、提示块这些内容,最后再整体顺一遍就差不多了。
```bash
pnpm build
```
:::
::::

下面是实际效果:

安装依赖

先把项目依赖装好,运行 pnpm install 即可。

启动开发环境

运行开发命令之后,一边改内容一边看效果会方便很多。

  • 本地开发:pnpm dev
  • 构建检查:pnpm build

检查最终效果

文章、图片、提示块这些内容,最后再整体顺一遍就差不多了。

Terminal window
pnpm build

目前先加了这四个,后面有别的再慢慢补。