Test Admonition

Admonition Test Page

这个页面用来测试 Hugo render hooks 实现的 admonition 功能。

基础 Admonition 类型

Note 类型

这是一个提示

这里是提示的内容,可以包含多行文本和其他 markdown 元素。

重要信息: 支持粗体文本和其他格式。

Info 类型

信息提示

这是一条信息性内容,通常用于向读者提供有用的背景知识。

Tip 类型

实用技巧

这里分享一个实用的小技巧,可以帮助提高效率。

  • 支持列表项
  • 也支持代码:hugo server --buildDrafts

Warning 类型

注意事项

请注意这个重要的警告信息。在执行某些操作之前,请确保备份重要数据。

Danger 类型

危险警告

这是一个危险操作的警告。执行此操作可能导致数据丢失或系统损坏。

可折叠的 Admonition

剧透内容(可折叠)

点击查看剧透

《星球大战》中,达斯·维德其实是卢克的父亲。这个情节是电影史上最著名的转折之一。

可折叠的代码示例

点击展开代码示例

以下是一个简单的 Hugo shortcode 示例:

{{ $title := .Get "title" | default "Default Title" }}
<div class="custom-block">
  <h3>{{ $title }}</h3>
  {{ .Inner | markdownify }}
</div>

可折叠的技术细节

高级用法说明

如果你想深入了解 Hugo render hooks,可以查看以下内容:

  1. Blockquote Render Hook: 处理引用块的自定义渲染
  2. 属性支持: 可以为引用添加自定义属性
  3. 条件渲染: 根据内容判断是否应用 admonition 样式

更多信息请参考 Hugo 官方文档

带属性的引用

普通引用

代码是写给人看的,恰好也能在机器上运行。

带作者的引用

生活就像一盒巧克力,你永远不知道下一颗是什么味道。

阿甘, 阿甘正传

只有来源的引用

知识就是力量。

培根

技术引用

任何能够出错的事情,都会出错。

墨菲, 墨菲定律

嵌套内容测试

包含代码的 Admonition

配置提示

在使用 admonition 功能之前,请确保你的 config.toml 包含以下配置:

[markup.goldmark.parser.attribute]
block = true
title = true

包含列表的 Admonition

功能特性

当前 admonition 功能支持:

  • ✅ 多种类型(note, info, tip, warning, danger, spoilers)
  • ✅ 可折叠内容(使用 + 符号)
  • ✅ 自定义标题
  • ✅ 嵌套 Markdown 内容
  • ✅ 暗色主题适配

包含表格的 Admonition

类型对照表
类型颜色图标用途
note蓝色一般信息
info蓝色重要信息
tip绿色💡技巧提示
warning橙色警告注意
danger红色🚨危险警告
spoilers紫色👁剧透内容

常规 Blockquote

这些是常规的引用块,不使用 admonition 语法:

这是一个普通的引用块。它保持传统的引用样式,不会被转换为 admonition。

程序员的三大美德:懒惰、急躁和傲慢。

Larry Wall

优化代码的第一条规则:不要优化。 优化代码的第二条规则(仅限专家):还是不要优化。

混合使用示例

在实际使用中,你可能会这样组合不同的内容:

重要提醒

在开始之前,请注意以下几点:

然后是一个普通的引用:

最好的代码是没有代码。

最后再来一个技巧:

高级技巧

如果你想要更好的性能,可以考虑:

hugo --minify --gc

这会启用压缩并进行垃圾回收。