#Markdown 功能展示

本文展示 Lichtung 主题支持的各种 Markdown 扩展功能。

##提示块（Alert Blockquotes）

使用 GitHub Flavored Markdown 的提示块语法：

markdown

> [!note]
> 这是一条 note 类型的提示。
>
> > [!TIP] 自定义标题
> > 可以嵌套

> [!note]+
> 这条 note 默认展开。使用 `+` 控制默认状态。

> [!note]-
> 这条 note 默认展开。使用 `+` 控制默认状态。

> [!warning]
> 这是一条警告。

> [!tip]
> 这是一条小贴士。

> [!important]
> 这是一条重要提示。

> [!caution]
> 请小心操作！

NOTE
这是一条 note 类型的提示。
自定义标题
可以嵌套

NOTE

这条 note 默认展开。使用 + 控制默认状态。

默认关闭

这条 note 默认展开。使用 - 控制默认状态。

WARNING
这是一条警告。

TIP
这是一条小贴士。

IMPORTANT
这是一条重要提示。

CAUTION
请小心操作！

##代码块

普通代码块带有语言标签和复制按钮：

代码块会被包裹在 <details open> 中
<summary> 显示语言名
右上角 copy 按钮可复制代码内容
有语言名时使用 Hugo Chroma 高亮

python

def hello():
    print("Hello, Lichtung!")
    return 42

javascript

// 点击代码块右上角的 copy 按钮复制代码
document.querySelector(".copybtn").addEventListener("click", function () {
  // 代码已被复制
});

##代码块内联属性

package main

import "fmt"

func main() {
    fmt.Println("Hello, 世界")
}

##Mermaid 图表

使用 mermaid 代码块绘制图表：

graph TD
    A[开始] --> B{是否继续?}
    B -->|是| C[继续处理]
    B -->|否| D[结束]
    C --> B

sequenceDiagram
    participant 用户
    participant 浏览器
    participant 服务器
    用户->>浏览器: 访问页面
    浏览器->>服务器: HTTP 请求
    服务器-->>浏览器: HTML 响应
    浏览器-->>用户: 渲染页面

##数学公式

行内公式： $E = mc^2$ 或 $ax^2 + bx + c = 0$

块级公式：

\int_{-\infty}^{\infty} e^{-x^2} \, dx = \sqrt{\pi}

\frac{d}{dx} \left( \int\_{a}^{x} f(t) \, dt \right) = f(x)

需要在 hugo.toml 中自定义：

toml

[markup.goldmark.extensions.passthrough.delimiters]
block = [['\[', '\]'], ['$$', '$$']]
inline = [['\(', '\)'],['$','$']]

并（在页面或全局）开启 math: true。

##表格

功能	支持	说明
提示块	✅	`> [!note]` 语法
Mermaid	✅	代码块指定 mermaid 语言
行内公式	✅	`$` 或 `$...$` 包裹
行间公式	✅	`$$` 或 `\[...\]` 包裹
任务列表	✅	`- [x]` 语法
删除线	✅	`~~文本~~`
标记	✅	`==文本==`

##任务列表

已完成的任务
另一个已完成的任务
未完成的任务
待办事项

##外部链接

这篇文章链接到了 Hugo 官网。外部链接会自动添加出链图标并新窗口打开。

还有这个： GitHub。

##内部链接

内部链接（指向本站其他页面）不会添加出链图标，而是被追踪为交叉链接：

这些内部链接会被自动记录到 CROSSLINKS 数据中，用于显示"出链"和"入链"。

##图片

示例图片

图片通过主题的 render-image hook 渲染：

外层包裹 <figure>
点击图片会在新窗口打开原图
alt 文本会作为 <figcaption> 显示
自动添加 loading="lazy" 延迟加载
data-sub-html 保存图片说明，便于接入 lightbox

语法仍然是标准 Markdown：

markdown

![示例图片](/favicon.ico)

##标题锚点

每个标题都会自动生成锚点链接。鼠标悬停在标题上可以看到 # 符号，点击可复制链接。

##定义列表

Lichtung: 德语，意为"林中空地"; 海德格尔哲学概念
Hugo: 一个 Go 语言编写的静态网站生成器; 以速度闻名

##脚注

这是一段需要注释的文字¹。这是另一段²。

##额外扩展（Goldmark Extras）

~~这是删除的文本~~，~~这条也被删除了~~。

这是插入的文本。

这是标记的文本。

H₂O 是水的化学式，E=mc² 是质能方程。

上标支持：X² + Y² = Z²。下标支持：CH₃CH₂OH。

这是第一条脚注的内容。 ↩︎
这是第二条脚注，可以包含多段文字。
第二段内容缩进即可。 ↩︎