在帖子中使用多种风格进行标注

目前可以在主题中使用多种方式进行标注,使用简单。可作为 Markdown 引用的替代方案。标注可以突出显示内容、在帖子中添加注释、警告或其他特殊信息的绝佳方式。

使用方式:

笔记

别名(同等名称):笔记、note

> [!笔记]
> 可作为 Markdown 引用的替代方案。
> [!note]
> 可作为 Markdown 引用的替代方案。

[!笔记]
可作为 Markdown 引用的替代方案。

摘要

别名:摘要、summary, tldr,abstract

> [!摘要]
> 可作为 Markdown 引用的替代方案。

[!摘要]
可作为 Markdown 引用的替代方案。

信息

别名:信息、info,提醒

> [!信息] 这是信息
> 可作为 Markdown 引用的替代方案。

[!信息] 这是信息
可作为 Markdown 引用的替代方案。

任务

别名:任务、todo

> [!任务]
> - [x] Write documentation
> - [ ] Add tests
> - [ ] Review code

[!任务]

  • 创建
  • 测试
  • 审阅

技巧 / 重要

别名:技巧、hint, important, tips,重要

> [!技巧] 这是技巧
> 可作为 Markdown 引用的替代方案。

[!技巧] 这是技巧
可作为 Markdown 引用的替代方案。

成功 / 完成

别名:成功、完成、check, done, success

> [!done] 已完成
> 可作为 Markdown 引用的替代方案。

[!done] 已完成
可作为 Markdown 引用的替代方案。

问题

别名:问题、提问、help, faq, question

> [!问题} 我有问题
> 可作为 Markdown 引用的替代方案。

[!问题] 我有问题
可作为 Markdown 引用的替代方案。

警告

别名:警告、caution, attention, warning

> [!警告] 这是一个警告
> 可作为 Markdown 引用的替代方案。

[!警告] 这是一个警告
可作为 Markdown 引用的替代方案。

失败

别名:失败、fail, missing, failure

> [!失败]
> 可作为 Markdown 引用的替代方案。

[!失败]
可作为 Markdown 引用的替代方案。

危险 / 错误

别名:error, 危险,错误,danger

> [!错误]
> 可作为 Markdown 引用的替代方案。

[!错误]
可作为 Markdown 引用的替代方案。

bug

> [!bug]
> 可作为 Markdown 引用的替代方案。

[!bug]
可作为 Markdown 引用的替代方案。

举例

别名:举例、例子、example

> [!例子]
> 可作为 Markdown 引用的替代方案。

[!例子]
可作为 Markdown 引用的替代方案。

引用

别名:引用、cite、quote

> [!引用]
> 可作为 Markdown 引用的替代方案。

[!引用]
可作为 Markdown 引用的替代方案。


类型 描述 别名 说明
note 用于通用备注和信息 笔记 摘要
abstract 用于总结或摘要部分 summary, tldr,摘要 信息
info 用于信息性内容 信息,提醒 -
todo 用于任务列表或待办事项 任务 待办
tip 用于提示和重要信息 hint, important, 技巧,重要 -
success 用于成功消息 check, done, 成功 -
question 用于问题和常见问题 help, faq, 问题 -
warning 用于警告 caution, attention, 警告 -
failure 用于失败通知 fail, missing, 失败 -
danger 用于危险或错误消息 error, 危险,错误 -
bug 用于错误报告或已知问题 - -
example 用于示例 例子,举例 -
quote 用于引用 cite, 引用 -

一些例子

显示时区

> [!信息] [date=2032-12-22 time=15:30:00 timezone="Asian/shanghai"]
> 这是一个带有世界时间的信息

2032-12-22T07:30:00Z
这是一个带有时区的信息,可以显示当前所在时间。

关于更多时间有关的内容,请参阅《如何在帖子中插入日期、时区、时间

展开

在标识符后直接添加加号 + 或减号 - 来使标注可折叠。

> [!摘要]+
> 可作为 Markdown 引用的替代方案。

[!摘要]+
可作为 Markdown 引用的替代方案。

多层嵌套

> [!信息]
> 这是一些信息。
> > [!成功]+
> > 这是成功信息!
> 
> > [!失败]+
> > 这是失败信息!

[!信息]
这是一些信息。

[!成功]+
这是成功信息!

[!失败]+
这是失败信息!


如果你有其他需要的格式、图标、颜色、边框,可以直接留言定制(需要有广泛性)

1 Like

[!tip]
Tip: Use code snippets to enhance readability. They provide clarity and precision.

[!cite] 引用
测试

[!question] Custom Label :hugs:
Callouts labels can be customized.

[!abstract] 2032-12-21T23:00:00Z
They can also contain special inline formatting like dynamic dates.
漂亮呀

类型 描述 别名 说明
note 用于通用备注和信息 笔记 摘要
abstract 用于总结或摘要部分 summary, tldr,摘要 信息
info 用于信息性内容 信息,提醒 -
todo 用于任务列表或待办事项 任务 待办
tip 用于提示和重要信息 hint, important, 技巧,重要 -
success 用于成功消息 check, done, 成功 -
question 用于问题和常见问题 help, faq, 问题 -
warning 用于警告 caution, attention, 警告 -
failure 用于失败通知 fail, missing, 失败 -
danger 用于危险或错误消息 error, 危险,错误 -
bug 用于错误报告或已知问题 - -
example 用于示例 例子,举例 -
quote 用于引用 cite, 引用 -
1 Like

用法:

> [!tip] 
> **Tip**: Use `code snippets` to enhance readability. They provide clarity and precision.
> [!question] Custom Label 🤗
> Callouts labels can be customized.

> [!abstract] [date=2032-12-22 timezone="Europe/Paris"]
> They can also contain special inline formatting like dynamic dates.

试试中文:

[!便签] 笔记
1234

[!摘要] 摘要
1234

[!信息] 信息
1234

[!todo] todo
1234

[!技巧] 技巧
1234

[!成功] 成功
1234

[!问题] 问题
1234

[!警告]警告
1234
ddav

[!失败] 失败
1234

[!危险] 危险
1234

[!bug] bug
1234

[!例子] 例子
1234

[!引用] 引用
1234

[!信息] 标题
我今天靠收破烂赚了6万元,你们呢:face_savoring_food:
其他文字

[!问题]

[!警告]
这不是吹牛

[!警告]
不要吹牛

怎么嵌套

> [!question] Can callouts be nested?
>
> > [!信息] Yes!, they can.
> >
> > > [!example] You can even use multiple layers of nesting.

[!warning] 警告

不要吹牛

需要用引用 > 开头

中文和英文标签的颜色好像不一样,我用的是 warning,warning 的警告是橙色的

[!warning] 警告

不要吹牛

[!attention] 警告 attention

不要吹牛

[!警告] 警告

不要吹牛

似乎是别名的问题。

修好了

专门试一下

[!todo]+ 任务

  • Create repository
  • Setup CI/CD
  • Deploy to production
> [!todo]+ 任务
>
> - [x] Create repository
> - [ ] Setup CI/CD
> - [ ] Deploy to production

[!note]- 也来做个测试
(>﹏<)