给 MDX 添加了一些扩展能力
2026.04.05
折腾之路 1484 字数
- 阅读
- 评论
目录
目录
最近顺手给博客补了几项常用的 MDX 能力。
这篇不聊实现,主要就是简单看看现在已经加了什么,以及实际显示效果怎么样。
1. Callout
现在更适合直接写容器语法,而不是继续包一层 MDX 组件:
:::warning[注意]这里是一段提醒内容。:::支持的 type 目前有这几个:
notetipimportantwarningcaution
另外也兼容 GitHub 那种 > [!NOTE] 提示块写法。
下面这些是实际渲染效果:
2. Link
链接会统一处理,外链会自动带一个小图标。
下面是实际效果:
这是一个站内链接:关于页
这是一个外部链接:Astro 官网
放在列表里也是同样的样式:
3. Img
图片现在也会走统一样式,本地图片和远程图片都可以用,标题会显示成说明文字。
下面是实际效果:
4. Steps
如果是教程或者流程记录,现在也可以直接写步骤容器。
::::steps:::step[安装依赖]先把项目依赖装好,运行 `pnpm install` 即可。:::
:::step[启动开发环境]运行开发命令之后,一边改内容一边看效果会方便很多。
- 本地开发:`pnpm dev`- 构建检查:`pnpm build`
:::
:::step[检查最终效果]文章、图片、提示块这些内容,最后再整体顺一遍就差不多了。
```bashpnpm build```
:::::::下面是实际效果:
安装依赖
先把项目依赖装好,运行 pnpm install 即可。
启动开发环境
运行开发命令之后,一边改内容一边看效果会方便很多。
- 本地开发:
pnpm dev - 构建检查:
pnpm build
检查最终效果
文章、图片、提示块这些内容,最后再整体顺一遍就差不多了。
pnpm build目前先加了这四个,后面有别的再慢慢补。