什么是 Slug？#

Slug 是文章 URL 路径的自定义部分。如果不设置 slug，系统将使用文件名作为 URL。

Slug 使用示例#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
---

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
slug: hello-world
5
---

1
---
2
title: 如何使用 Firefly 博客主题
3
published: 2023-09-09
4
slug: how-to-use-firefly-blog-theme
5
---

Slug 使用建议#

1. 使用英文和连字符：my-awesome-post 而不是 my awesome post
2. 保持简洁：避免过长的 slug
3. 具有描述性：让 URL 能够反映文章内容
4. 避免特殊字符：只使用字母、数字和连字符
5. 保持一致性：在整个博客中使用相似的命名模式

注意事项#

• Slug 一旦设置并发布，建议不要随意更改，以免影响 SEO 和已存在的链接
• 如果多个文章使用相同的 slug，后面的文章会覆盖前面的
• Slug 会自动转换为小写

1. 开通 Zero Trust#

1. 登录 Cloudflare 后台，左侧点 Zero Trust
2. 设置团队名称（随意），到付款页面选 Free 计划，完成开通

Free 计划支持 50 用户以内免费使用 Access，个人用完全够。如果当时跳过了套餐选择，后续在 Access → 应用程序 页面会提示”选择计划”，点进去选 Free 即可。

2. 创建隧道#

1. Zero Trust 后台 → 左侧 Networks → Tunnels
2. 点 Create a tunnel → 选 Cloudflared → 下一步
3. 给隧道命名（比如 fnos-tunnel）→ 保存
4. 安装方式选 Docker，复制页面给出的 token（后面要用）

关键：必须用 host 网络模式#

如果用默认 bridge 网络，容器里的 127.0.0.1 是容器自己，访问不到宿主机上的服务，会报 connection refused。

在 FnOS 上创建 docker-compose.yml：

1
version: '3'
2
services:
3
  cloudflared:
4
    image: cloudflare/cloudflared:latest
5
    container_name: cloudflared
6
    network_mode: host
7
    restart: unless-stopped
8
    command: tunnel --no-autoupdate run --token 这里替换成你的token

启动：

1
docker compose up -d

验证容器运行状态：

1
docker ps | grep cloudflared

确认网络模式是 host：

1
docker inspect cloudflared | grep NetworkMode

输出必须是 "NetworkMode": "host"。

回到 Cloudflare 隧道页面，等连接器状态变绿，点 Next。

关键：URL 用 127.0.0.1，不要用本机局域网 IP#

ESXI 虚拟机内，程序访问本机网卡 IP（如 10.0.0.4:8080）会触发虚拟交换机回流拦截，导致超时。用 127.0.0.1 走本地回环，不走网卡，避开这个问题。

点 Save hostname 保存，配置立即生效，不用重启容器。

问题 1：502 Bad Gateway，日志报 dial tcp 127.0.0.1:端口: connect: connection refused#

原因：cloudflared 容器不是 host 网络模式。

解决：确认 docker-compose.yml 里有 network_mode: host，重建容器。

1
docker compose down && docker compose up -d

问题 2：502，日志报 dial tcp 10.0.0.x:端口: i/o timeout#

原因：URL 填了本机局域网 IP，ESXI 虚拟交换机拦截回流流量。

解决：隧道后台把 URL 改成 127.0.0.1:端口。

问题 3：502，日志报 Host validation failed#

原因：后端服务强制校验 Host 头。

解决：隧道后台编辑该域名 → Additional application settings → HTTP Host Header 填入后端服务认可的域名。

问题 4：查看 cloudflared 日志#

1
docker logs cloudflared --tail 50

日志里会明确写清楚连哪个地址失败，根据报错对应上面的问题处理。

配置步骤#

1. 进入 Zero Trust 后台 → 左侧 访问控制 → 应用程序
2. 点 Add an application → 选 Self-hosted
3. 填写：
   • Application name：随意，比如 我的NAS
   • Session duration：选 24 hours 或更久
   • Application domain：选你的域名，子域名填你要保护的那个（比如 music）
4. 点 Next
5. Policy name：随意，比如 允许我自己
6. Action：选 Allow
7. Include 规则里：
   • 选 Email
   • 填你的邮箱地址（只有这个邮箱能登录访问）
8. 点 Next → 点 Add application 保存

效果#

以后访问受保护的子域名，会先跳转到 Cloudflare 登录页，输入你授权的邮箱，收验证码登录后才能进入服务。

多个服务#

每个子域名单独建一个 Application，分别保护。或者建一个 Application，domain 那里选 *.你的域名，一次性保护所有子域名。

1. 开通 Zero Trust#

1. 登录 Cloudflare 后台，左侧点 Zero Trust
2. 设置团队名称（随意），到付款页面选 Free 计划，完成开通

Free 计划支持 50 用户以内免费使用 Access，个人用完全够。

2. 创建隧道#

1. Zero Trust 后台 → 左侧 Networks → Tunnels
2. 点 Create a tunnel → 选 Cloudflared → 下一步
3. 给隧道命名（比如 synology-tunnel）→ 保存
4. 安装方式选 Docker，复制页面给出的 token（后面要用）

关键：必须用 host 网络模式#

如果用默认 bridge 网络，容器里的 127.0.0.1 是容器自己，访问不到群晖宿主机上的服务，会报 connection refused。

提供两种部署方式，任选其一。

方式 A：SSH + docker-compose（推荐，最稳定）#

1
ssh 你的群晖用户名@群晖IP

1
mkdir -p /volume1/docker/cloudflared
2
cd /volume1/docker/cloudflared

1
version: '3'
2
services:
3
  cloudflared:
4
    image: cloudflare/cloudflared:latest
5
    container_name: cloudflared
6
    network_mode: host
7
    restart: unless-stopped
8
    command: tunnel --no-autoupdate run --token 这里替换成你的token

1
docker compose up -d

1
docker ps | grep cloudflared

1
docker inspect cloudflared | grep NetworkMode

方式 B：Container Manager 图形界面#

适合不想用命令行的用户。

关键：URL 用 127.0.0.1，不要用群晖局域网 IP#

群晖虚拟机内（ESXI 环境），程序访问本机网卡 IP（如 10.0.0.3:5000）可能触发虚拟交换机回流拦截。用 127.0.0.1 走本地回环，不走网卡，最稳。

点 Save hostname 保存，配置立即生效，不用重启容器。

问题 1：502 Bad Gateway，日志报 dial tcp 127.0.0.1:端口: connect: connection refused#

原因：cloudflared 容器不是 host 网络模式。

解决：

• docker-compose 方式：确认 docker-compose.yml 里有 network_mode: host，重建容器

  1
  docker compose down && docker compose up -d

• 图形界面方式：编辑容器 → 网络 → 勾选”使用与 Docker Host 相同的网络”

问题 2：502，日志报 dial tcp 10.0.0.x:端口: i/o timeout#

原因：URL 填了群晖局域网 IP，ESXI 虚拟交换机拦截回流流量。

解决：隧道后台把 URL 改成 127.0.0.1:端口。

问题 3：502，日志报 Host validation failed#

原因：后端服务强制校验 Host 头。

解决：隧道后台编辑该域名 → Additional application settings → HTTP Host Header 填入后端服务认可的域名。

问题 4：群晖 DSM 管理界面穿透后登录跳转回内网 IP#

原因：DSM 会强制跳转，需要配置 Host Header。

解决：隧道后台编辑 DSM 对应的域名 → Additional application settings → HTTP Host Header 填入你的外网域名（比如 dsm.你的域名）。

问题 5：查看 cloudflared 日志#

1
docker logs cloudflared --tail 50

图形界面用户：Container Manager → 容器 → 点 cloudflared → 日志。

日志里会明确写清楚连哪个地址失败，根据报错对应上面的问题处理。

配置步骤#

1. 进入 Zero Trust 后台 → 左侧 访问控制 → 应用程序
2. 点 Add an application → 选 Self-hosted
3. 填写：
   • Application name：随意，比如 群晖DSM
   • Session duration：选 24 hours 或更久
   • Application domain：选你的域名，子域名填你要保护的那个（比如 dsm）
4. 点 Next
5. Policy name：随意，比如 允许我自己
6. Action：选 Allow
7. Include 规则里：
   • 选 Email
   • 填你的邮箱地址（只有这个邮箱能登录访问）
8. 点 Next → 点 Add application 保存

效果#

以后访问受保护的子域名，会先跳转到 Cloudflare 登录页，输入你授权的邮箱，收验证码登录后才能进入服务。

多个服务#

每个子域名单独建一个 Application，分别保护。或者建一个 Application，domain 那里选 *.你的域名，一次性保护所有子域名。

一、技术层：AI 渗透全链路，重构生产、营销、客服、供应链#

二、渠道格局：全域分层，单一平台很难做大盘#

渠道分工越来越清晰，全域经营是商家必修课：

一句话总结：货架解决”我要买什么”，内容解决”我想买点什么”，即时零售解决”我现在就要”，私域解决”反复找我买”。

三、供给与消费：国货崛起、品质优先、分层消费、绿色电商#

四、跨境电商：多模式并行，从铺货走向品牌出海#

五、供应链与履约：柔性化、本地化、仓配一体化#

六、监管与规则：全面合规，野蛮生长时代结束#

• 价格监管、虚假宣传、直播合规、达人财税、知识产权、数据安全、用户隐私保护持续收紧；
• 算法治理：平台推荐算法更透明，无序比价、流量垄断、大数据杀熟持续整治；
• 刷单、刷评、虚假直播、夸大宣传处罚力度加大，合规能力直接决定商家能不能活下去。

七、对不同角色的启示#

风险提示#

1. 居民消费复苏节奏存在不确定性，消费信心波动会影响可选品类；
2. 国际地缘、海外贸易政策变化直接冲击跨境；
3. AI 工具同质化，单纯靠 AI 内容无法建立长期壁垒；
4. 流量成本长期上行，没有复购能力的生意模型会越来越难。

语法高亮#

语法高亮

1
console.log('此代码有语法高亮!')

1
Standard ANSI colors:
2
- Dimmed:      Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
3
- Foreground:  Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
4
- Background:  Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
5
- Reversed:    Black  Red  Green  Yellow  Blue  Magenta  Cyan  White 
6

7
8-bit colors (showing colors 160-171 as an example):
8
- Dimmed:      160  161  162  163  164  165  166  167  168  169  170  171 
9
- Foreground:  160  161  162  163  164  165  166  167  168  169  170  171 
10
- Background:  160  161  162  163  164  165  166  167  168  169  170  171 
11
- Reversed:    160  161  162  163  164  165  166  167  168  169  170  171 
12

13
24-bit colors (full RGB):
14
- Dimmed:      ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
15
- Foreground:  ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
16
- Background:  ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
17
- Reversed:    ForestGreen - RGB(34,139,34)  RebeccaPurple - RGB(102,51,153) 
18

19
Font styles:
20
- Default
21
- Bold
22
- Dimmed
23
- Italic
24
- Underline
25
- Reversed
26
- Strikethrough

编辑器和终端框架#

编辑器和终端框架

1
console.log('标题属性示例')

1
<div>文件名注释示例</div>

1
echo "此终端框架没有标题"

1
Write-Output "这个有标题!"

1
echo "看，没有框架!"

1
# 如果不覆盖，这将是一个终端框架
2
function Watch-Tail { Get-Content -Tail 20 -Wait $args }
3
New-Alias tail Watch-Tail

文本和行标记#

文本和行标记

1
// 第1行 - 通过行号定位
2
// 第2行
3
// 第3行
4
// 第4行 - 通过行号定位
5
// 第5行
6
// 第6行
7
// 第7行 - 通过范围 "7-8" 定位
8
// 第8行 - 通过范围 "7-8" 定位

1
function demo() {
2
  console.log('此行标记为已删除')
3
  // 此行和下一行标记为已插入
4
  console.log('这是第二个插入行')
5

6
  return '此行使用中性默认标记类型'
7
}

1
<button
2
  role="button"
3
  {...props}
4
  value={value}
5
  className={buttonClassName}
6
  disabled={disabled}
7
  active={active}
8
>
9
  {children &&
10
    !active &&
11
    (typeof children === 'string' ? <span>{children}</span> : children)}
12
</button>

1
<button
2
  role="button"
3
  {...props}
4

5
  value={value}
6
  className={buttonClassName}
7

8
  disabled={disabled}
9
  active={active}
10
>
11

12
  {children &&
13
    !active &&
14
    (typeof children === 'string' ? <span>{children}</span> : children)}
15
</button>

1
此行将标记为已插入
2
此行将标记为已删除
3
这是常规行

1
--- a/README.md
2
+++ b/README.md
3
@@ -1,3 +1,4 @@
4
+this is an actual diff file
5
-all contents will remain unmodified
6
 no whitespace will be removed either

1
function thisIsJavaScript() {
2
  // 整个块都会以 JavaScript 高亮显示，
3
  // 并且我们仍然可以为其添加 diff 标记！
4
  console.log('要删除的旧代码')
5
  console.log('新的闪亮代码！')
6
}

1
function demo() {
2
  // 标记行内的任何给定文本
3
  return '支持给定文本的多个匹配项';
4
}

1
console.log('单词 yes 和 yep 将被标记。')

1
echo "Test" > /home/test.txt

1
function demo() {
2
  console.log('这些是插入和删除的标记类型');
3
  // return 语句使用默认标记类型
4
  return true;
5
}

自动换行#

自动换行

1
// 启用换行的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// wrap=false 的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// preserveIndent 示例（默认启用）
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// preserveIndent=false 的示例
2
function getLongString() {
3
  return '这是一个非常长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

为每个块显示行号#

1
// 此代码块将显示行号
2
console.log('来自第2行的问候!')
3
console.log('我在第3行')

// 此块禁用行号
console.log('你好?')
console.log('抱歉，你知道我在第几行吗?')

更改起始行号#

5
console.log('来自第5行的问候!')
6
console.log('我在第6行')

基本用法#

1
::: code-group labels=[code.js, code.py, code.html]
2

3
```js
4
export function greet(name) {
5
  return `Hello, ${name}!`;
6
}
7
```
8

9
```py
10
def greet(name):
11
    return f"Hello, {name}!"
12
```
13

14
```html
15
<p>Hello, world!</p>
16
```
17

18
:::

渲染效果：

1
export function greet(name) {
2
  return `Hello, ${name}!`;
3
}

1
def greet(name):
2
    return f"Hello, {name}!"

1
<p>Hello, world!</p>

标签中使用 Emoji#

标签支持 emoji 短代码，构建时会自动转换成 emoji：

1
::: code-group labels=[:package: npm, :package: pnpm, :yarn: yarn]

1
npm create astro@latest

1
pnpm create astro@latest

1
yarn create astro

与其他代码块特性组合#

组内仍是普通的 Expressive Code 代码块，标题、行号、行标记、折叠、终端框架等特性都可以照常使用。

1
export default {
2
  theme: "firefly",
3
  codeGroup: true,
4
};

1
pnpm build && pnpm preview

3 collapsed lines
1
// 这三行默认折叠
2
import { a } from "a";
3
import { b } from "b";
4

5
console.log(a, b);

不止是代码块#

标签页内可以放任意内容，例如文字、列表或图片：

在提醒框内使用（MDX 组件）#

::: code-group 和 ::: tip 等 Docusaurus 风格提醒框都使用 ::: 容器语法，而 micromark-directive 规定父子容器的冒号数必须不同，因此 ::: code-group 无法嵌套在 ::: tip 等提醒框内（整块会失效）。

这种情况改用 MDX 组件 TabGroup：MDX 组件不经过 ::: 指令解析，在提醒框内外都能正常使用，也方便日后扩展更多 UI 组件。把文章后缀改为 .mdx，从统一入口 @/components/firefly-mdx 引入（可一次引入多个组件）：

1
import { TabGroup } from "@/components/firefly-mdx";
2

3
:::tip
4

5
<TabGroup labels={["test.js", "test.py"]} client:load>
6
  ```js
7
  console.log(1)
8
  ```
9

10
  ```py
11
  print("hello world")
12
  ```
13
</TabGroup>
14

15
:::

1.1 单侧边栏模式#

左侧边栏 (position: “left”)#

右侧边栏 (position: “right”)#

1
export const sidebarLayoutConfig: SidebarLayoutConfig = {
2
  enable: true,
3
  position: "left", // 左侧边栏
4
};

1.2 双侧边栏模式 (position: “both”)#

布局结构#

1
export const sidebarLayoutConfig: SidebarLayoutConfig = {
2
  enable: true,
3
  position: "both", // 双侧边栏

2.1 列表模式 (defaultMode: “list”)#

列表布局结构#

1
export const siteConfig: SiteConfig = {
2
  postListLayout: {
3
    defaultMode: "list",    // 列表模式
4
    coverPosition: "right", // 封面图位置："right" 右侧，"left" 左侧
5
  },
6
};

2.2 网格模式 (defaultMode: “grid”)#

自适应网格#

网格模式通过 columnWidth 配置卡片的最小宽度（单位 px），浏览器会根据容器可用宽度自动计算能容纳多少列。

1
export const siteConfig: SiteConfig = {
2
  postListLayout: {
3
    defaultMode: "grid",
4
    grid: {
5
      masonry: true,      // 开启瀑布流
6
      columnWidth: 320,   // 卡片最小宽度(px)，浏览器自动计算列数
7
    },
8
  },
9
};

2.3 瀑布流布局 (Masonry)#

Firefly 的网格模式内置了智能瀑布流布局支持，解决了网格布局中因图文混合文章导致的卡片高度不一致导致的空白问题。

• 智能排版：自动将卡片放置到最短的列，最大化利用垂直空间。
• 消除空白：通过绝对定位精确计算每个卡片的位置，让卡片紧贴上方卡片，消除垂直方向的空白间隙。
• 自适应列数：瀑布流同样根据 columnWidth 和容器宽度动态计算列数，无需固定配置。
• 配置灵活：您可以在 siteConfig.ts 中通过 postListLayout.grid.masonry 选项自由开启或关闭此功能。

Q1: 如何调整网格列数？#

A: 通过 columnWidth 配置卡片最小宽度即可。值越小，同等宽度下列数越多；值越大，列数越少。浏览器会自动根据可用宽度计算最佳列数。

第一种：slug#

slug 写法在 Obsidian 中不支持，slug 是 Firefly 自己的概念，Obsidian 不读取 frontmatter 里的 slug，所以按 slug 写的链接在 Obsidian 里既不会自动补全，也点不动，只有构建出的站点上能正常跳转。如果你主要在 Obsidian 里写作，用下面两种写法。

第二种：文件路径（推荐）#

文件路径写法需要改 Obsidian 设置，在 设置 → 文件与链接 → 链接 → 内部链接类型 中选择基于仓库根目录的绝对路径，Obsidian 插入的链接才会带上目录：

1
[[guide/firefly-layout-system|firefly-layout-system]]

Firefly 布局系统详解

深入了解 Firefly 的布局系统，包括侧边栏布局（左侧/双侧）和文章列表布局（列表/网格），以及自适应网格列数。

1970-01-03文章示例#Firefly#布局#博客#指南

因为仓库根目录就是 src/content/posts，Obsidian 写出的这个路径和 Firefly 需要的路径完全一致，不需要任何额外转换。

上面这行末尾的 |firefly-layout-system 是 Obsidian 自动补的别名，Firefly 会忽略它，卡片标题仍然取文章的 title，除非你把它修改和文件名不一致，才会变成你修改后的别名。

内部链接类型下拉框里的基于当前笔记的相对路径只在同目录内可用：它给同目录文章生成的是裸文件名，能正常匹配；但跨目录时会生成 ../ 前缀，Firefly 无法解析，链接会按原文显示。

第三种：裸文件名#

「内部链接类型」的默认值就是尽可能简短的形式：只要文件名在整个仓库里唯一，Obsidian 插入的链接就只有文件名，不带目录。这种写法不需要改任何设置，效果和写完整路径完全一致：

1
[[firefly-layout-system]]

firefly-layout-system

文件名重名时这种写法会失效，构建日志里会给出提示，改用完整文件路径即可，所以推荐直接修改 Obsidian 内部链接类型设置为基于仓库根目录的绝对路径，使用第二种文件路径写法，一劳永逸

矩阵 (Matrices)#

极限与求和 (Limits and Sums)#

麦克斯韦方程组 (Maxwell’s Equations)#

化学方程式 (Chemical Equations)#

Tab分组：TabGroup#

用于创建可切换的标签页，方便在文章中展示不同语言或不同版本的代码等等。

1
<TabGroup labels={["test.js", "test.py"]} client:load>
2
  ```js
3
  console.log(1)
4
  ```
5

6
  ```py
7
  print("hello world")
8
  ```
9
</TabGroup>

1
console.log(1)

1
print("hello world")

时间线：Timeline / TimelineItem#

1
<Timeline>
2
  <TimelineItem date="2026-08-16" title="新版本发布" icon="rocket">
3
    发布了全新版本，带来以下更新：
4

5
    - 新增时间线组件
6
    - 改进暗色主题
7

8
    正文里支持 **Markdown** 内容。
9
  </TimelineItem>
10
  <TimelineItem date="2025-11-02" title="站点上线" type="tip" icon="flag">
11
    欢迎来到我的博客。
12
  </TimelineItem>
13
  <TimelineItem date="2025-06-15" title="项目立项" type="note">
14
    开始规划 Firefly 主题。
15
  </TimelineItem>
16
</Timeline>

1. 2026-08-16

   新版本发布

   发布了全新版本，带来以下更新：

   • 新增时间线组件
   • 改进暗色主题

   正文里支持 Markdown 内容。

2. 2025-11-02

   站点上线

   欢迎来到我的博客。

3. 2025-06-15

   项目立项

   开始规划 Firefly 主题。

步骤条：Steps / StepItem#

编号步骤条，适合教程、部署流程。编号自动生成，无需手动传序号。

1
<Steps>
2
  <StepItem title="安装依赖">
3
    运行 `pnpm install`。
4
  </StepItem>
5
  <StepItem title="启动开发服务器" type="tip" icon="rocket">
6
    运行 `pnpm dev`，打开 `localhost:4321`。
7
  </StepItem>
8
  <StepItem title="编写文章">
9
    在 `src/content/posts/` 新建 `.mdx` 文章。
10
  </StepItem>
11
</Steps>

1. 安装依赖

   运行 pnpm install。

2. 启动开发服务器

   运行 pnpm dev，打开 localhost:4321。

3. 编写文章

   在 src/content/posts/ 新建 .mdx 文章。

徽章：Badge#

内联彩色小徽章，可嵌在段落或标题里。

1
<Badge type="tip">提示</Badge> <Badge type="warning">注意</Badge>

更多信息，请查看 MDX 文档

1. GitHub 主题风格#

这是 GitHub 官方支持的 5 种基本类型。

基本语法

1
> [!NOTE] NOTE
2
> 突出显示用户应该考虑的信息。
3

4
> [!TIP] TIP
5
> 可选信息，帮助用户更成功。
6

7
> [!IMPORTANT] IMPORTANT
8
> 用户成功所必需的关键信息。
9

10
> [!WARNING] WARNING
11
> 关键内容，需要立即注意。
12

13
> [!CAUTION] CAUTION
14
> 行动的负面潜在后果。
15

16
> [!NOTE] 自定义标题
17
> 这是一个带有自定义标题的示例。

2. Obsidian 主题风格#

Obsidian 风格支持非常丰富的类型和别名。

1
> [!NOTE] NOTE
2
> 通用的笔记块。
3

4
> [!ABSTRACT] ABSTRACT
5
> 文章的摘要。
6

7
> [!SUMMARY] SUMMARY
8
> 文章的总结（同 Abstract）。
9

10
> [!TLDR] TLDR
11
> 太长不看（同 Abstract）。
12

13
> [!INFO] INFO
14
> 提供额外信息。
15

16
> [!TODO] TODO
17
> 需要完成的事项。
18

19
> [!TIP] TIP
20
> 实用技巧或提示。
21

22
> [!HINT] HINT
23
> 暗示（同 Tip）。
24

25
> [!IMPORTANT] IMPORTANT
26
> 重要信息（Obsidian 风格通常使用类似的图标）。
27

28
> [!SUCCESS] SUCCESS
29
> 操作成功。
30

31
> [!CHECK] CHECK
32
> 检查通过（同 Success）。
33

34
> [!DONE] DONE
35
> 已完成（同 Success）。
36

37
> [!QUESTION] QUESTION
38
> 提出问题。
39

40
> [!HELP] HELP
41
> 寻求帮助（同 Question）。
42

43
> [!FAQ] FAQ
44
> 常见问题（同 Question）。
45

46
> [!WARNING] WARNING
47
> 警告信息。
48

49
> [!CAUTION] CAUTION
50
> 注意事项（同 Warning）。
51

52
> [!ATTENTION] ATTENTION
53
> 引起注意（同 Warning）。
54

55
> [!FAILURE] FAILURE
56
> 操作失败。
57

58
> [!FAIL] FAIL
59
> 失败（同 Failure）。
60

61
> [!MISSING] MISSING
62
> 缺失内容（同 Failure）。
63

64
> [!DANGER] DANGER
65
> 危险操作警告。
66

67
> [!ERROR] ERROR
68
> 错误信息（同 Danger）。
69

70
> [!BUG] BUG
71
> 报告软件缺陷。
72

73
> [!EXAMPLE] EXAMPLE
74
> 展示一个例子。
75

76
> [!QUOTE] QUOTE
77
> 引用一段话。
78

79
> [!CITE] CITE
80
> 引证（同 Quote）。
81

82
> [!NOTE] 自定义标题
83
> 这是一个带有自定义标题的示例。