半神短代码兼容 Hugo 风格写法,也支持更轻的 ::: 容器写法。目标是让普通 Markdown 文章也能使用稳定的正文组件。
设计原则
短代码只做文章表达需要的组件,不把页面功能强塞进正文。静态站点无法可靠实现的回复可见和复杂加密,会降级为折叠提示块。
兼容写法
旧 Demius 的 button、collapse、tabs、timeline、linkcard、bilibili 等写法可以逐步迁移到半神。
折叠说明
折叠块适合放长说明、命令输出、配置片段或不想默认展开的内容。
- 支持 Markdown 列表
- 支持普通链接和代码
- 移动端不会撑破正文宽度
提示块适合强调信息,支持 info、tip、success、warning、danger。
链接卡片适合替代裸链接,尤其是外链参考和站内文章引用。
通过 remark 插件在构建期把短代码转换成静态 HTML。
后续可以根据实际文章需要继续增加 Mermaid、相册组和下载卡片。
::: 容器写法
这种写法更接近现代 Markdown 插件的容器语法,适合新文章直接使用。
这一行展示 主题色文字 的内联写法。
评论区