Hexo-admonition 插件安装使用指南
发布于: 2020 年 04 月 30 日
简介
Hexo 内容辅助插件，支持将类似 reStructuredText 的警告提示块添加到 Markdown 文档中。例如 note、warning、error 等提示块，效果如图：
Hexo-admonition 示例效果
开发这个插件的动机，是想让 hexo 与 Material for MkDocs 的提示信息兼容，让系列文章在基于 MkDocs 搭建的子站中有更好的阅读体验。
查看更多内容，请访问博文：Hexo-admonition 插件安装使用指南。
安装说明
安装插件
bash
复制代码
使用指南
语法说明
Hexo-admonition 遵循一种简单的语法：每个块都以 !!! 开头，然后是代表提示类型的关键字（type）及标题（title）。例如:
text
复制代码
在 Hexo 渲染前，将被转换成如下内容：
html
复制代码
最终呈现效果如下：
hexo-admonition 插件 note 提示示例
支持的类型
提示类型 type 将用作 CSS 类名称，暂支持如下类型：
noteinfo, todowarning, attention, cautionerror, failure, missing, fail
设置/隐藏标题
标题 title 是可选的，当未设置时，将以 type 作为默认值:
text
复制代码
效果如下：
默认标题警告提示块
如果不想显示标题，可以将 title 设置为 ""：
text
复制代码
效果如下：
无标题警告提示块
嵌套 markdown 标记
在 hexo-admonition 内部，还可以嵌套标准 Markdown 标签，例如：
text
复制代码
效果如下:
嵌套效果
样式配置
将如下样式放入 hexo 主题的自定义样式文件中（如：my.css），并按自己喜好修改：
css
复制代码
License
MIT
参考
产业转型创新实践者，资深区块链专家。 2019.09.05 加入
欢迎访问我的博客：http://lixl.cn
评论