半神文章短代码示例

展示半神主题内置的提示、按钮、链接卡片、折叠、选项卡、时间线和媒体短代码。

主题开发 #Astro#主题#Shortcode

半神短代码兼容 Hugo 风格写法,也支持更轻的 ::: 容器写法。目标是让普通 Markdown 文章也能使用稳定的正文组件。

设计原则

短代码只做文章表达需要的组件,不把页面功能强塞进正文。静态站点无法可靠实现的回复可见和复杂加密,会降级为折叠提示块。

兼容写法

旧 Demius 的 buttoncollapsetabstimelinelinkcardbilibili 等写法可以逐步迁移到半神。

查看全部文章 GitHubvhAstro-Theme参考文章能力、媒体展示和主题配置思路。
折叠说明

折叠块适合放长说明、命令输出、配置片段或不想默认展开的内容。

  • 支持 Markdown 列表
  • 支持普通链接和代码
  • 移动端不会撑破正文宽度

提示块适合强调信息,支持 infotipsuccesswarningdanger

链接卡片适合替代裸链接,尤其是外链参考和站内文章引用。

短代码系统接入

通过 remark 插件在构建期把短代码转换成静态 HTML。

继续补充扩展

后续可以根据实际文章需要继续增加 Mermaid、相册组和下载卡片。

::: 容器写法

这种写法更接近现代 Markdown 插件的容器语法,适合新文章直接使用。

半神主题 OG 图
半神主题 OG 图
半神短代码

这一行展示 主题色文字 的内联写法。

Comments

评论区

Artalk

输入关键词开始搜索。

0