博客探索 | 搬运一些Shortcodes

整理博客中可用的 Hugo Shortcodes,每个示例都附带可一键复制的源码。

目录

一直想用一些shortcodes来优化一下页面的呈现方式。现在每个示例都会先显示源码,把鼠标悬停在代码块右上角就会出现「Copy」按钮,点击即可复制。

特别感谢:

文字

重点标记

{{< mark text="好喜欢蓝色!" >}}
好喜欢蓝色!

文本折叠

{{< detail "点击展开" >}}
<p>这是第一个段落的内容。</p>

<p>这是第二个段落的内容,位于折叠部分,实际使用别忘了双括号!</p>
{{< /detail >}}
点击展开

这是第一个段落的内容。

这是第二个段落的内容,位于折叠部分,实际使用别忘了双括号!

文字黑幕

<span class="shady">数据删除!数据删除!<br>但总之换行的话就加个空标签。</span>
数据删除!数据删除!
但总之换行的话就加个空标签。

高斯模糊

<span class="blur">一些手动打码效果!<br>但总之换行的话就加个空标签。</span>
一些手动打码效果!
但总之换行的话就加个空标签。

文本位置

{{< align left "文字居左" >}}

文字居左

{{< align center "文字居中" >}}

文字居中

{{< align right "文字居右" >}}

文字居右

摘录引用

{{< blockquote author="加西亚·马尔克斯" link="也可以不加啦" title="《百年孤独》" >}}  
羊皮卷上所载一切自永远至永远不会再重复,因为注定经受百年孤独的家族不会有第二次机会出现在大地上出现。  
{{< /blockquote >}}

羊皮卷上所载一切自永远至永远不会再重复,因为注定经受百年孤独的家族不会有第二次机会出现在大地上出现。

居中引用

{{< quote-center >}}  
有些人说<br>换行敲多了<br>就是<br>诗  
{{< /quote-center >}}

有些人说
换行敲多了
就是

键盘样式

<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
Ctrl+Alt+Del

卡片

{{< card >}}  
可以在这里插入链接假装是卡片式链接。  
  
好像不能插入图片?  
  
换行需要空标签。实际使用需要双括号。  
{{< /card >}}

可以在这里插入链接假装是卡片式链接。

好像不能插入图片?

换行需要空标签。实际使用需要双括号。

标签块

{{< notice notice-warning >}}  
Warning:需要双括号。  
{{< /notice >}}

Warning:需要双括号。

{{< notice notice-info >}}  
info:这是一条信息。  
{{< /notice >}}

info:这是一条信息。

{{< notice notice-note >}}  
note:可以标注一下,但是没必要。  
{{< /notice >}}

note:可以标注一下,但是没必要。

{{< notice notice-tip >}}  
tip:在示例里胡说八道会使观看者会心一笑。  
{{< /notice >}}

tip:在示例里胡说八道会使观看者会心一笑。

对话框

{{< chat position="left" name="导师" timestamp="2024-10-12 14:30" >}}  
做一个论文阅读的大模型。  
{{< /chat >}}
导师   2024-10-12 14:30
做一个论文阅读的大模型。
{{< chat position="right" name="我" timestamp="2024-10-12 14:45" >}}  
好的老师。  
{{< /chat >}}
2024-10-12 14:45   我
好的老师。

时间轴

{{< timeline date="2024-10-20" title="创建ionfeather'Log" description="使用Hugo的Stack主题" tags="博客" url="" >}}
2024-10-20
博客
创建ionfeather'Log
使用Hugo的Stack主题
{{< timeline date="2024-11-04" title="增加评论区" description="部署Waline,但还有一些问题" tags="博客" url="" >}}
2024-11-04
博客
增加评论区
部署Waline,但还有一些问题
{{< timeline date="2025-02-13" title="Bug修复" description="修复了一些bug,如邮箱显示错误、搜索功能失效等" tags="博客" url="" >}}
2025-02-13
博客
Bug修复
修复了一些bug,如邮箱显示错误、搜索功能失效等

图片滚动

{{< imgloop "DSC_3245.jpg,DSC_3248.jpg,DSC_3304.jpg" >}}
DSC_3245.jpg
DSC_3248.jpg
DSC_3304.jpg

Bilibili

{{< bilibili BV1bKg46nE7k 0 0 >}}

网易云音乐

{{< netease 557578993 0 >}}

NeoDB

灵感来自小球飞鱼的 NeoDB 装修。填入条目的 NeoDB 链接,构建时自动拉取我的标记状态和封面;正文可留空(显示 NeoDB 上的评论),也可以自己写:

{{< neodb "https://neodb.social/movie/4ehThaQvoClePUiNK5E1J3" >}}
「今天就是明天。」—— 土拨鼠反复横跳的那一天,我也想再过一次。
{{< /neodb >}}
封面加载中
2026-08-14 看过 #Movie

「今天就是明天。」—— 土拨鼠反复横跳的那一天,我也想再过一次。

Mermaid 图表

这个不是 shortcode,直接用 ```mermaid 代码块就行,构建时会自动渲染成图表(只有用到的页面才加载 mermaid.js,明暗主题自动跟随):

graph LR
    A[写下一行文字] --> B{构建}
    B --> C[变成一张图]

标签墙

其实这个不算是shortcodes,但是我不知道把这个放在哪里。所以这个犄角旮旯就不错!

特别感谢:

标签墙最后放在了我的「关于」页面里。

欢迎大家去看!

All rights reserved.
最后更新于 Aug 29, 2026
使用 Hugo 构建
主题 StackJimmy 设计