概述¶
背景¶
- 使用 Markdown。
- Markdown 知识。
本指南演示了在 https://docs.rocky-linux.cn 上常用的 Markdown 标签，并包含 admonitions 标签，该标签不是标准 Markdown 标签的一部分。
演示¶
这是一个引用示例。格式精美。
有时，你会看到诸如 此类 的内容。
来点 粗体 如何？
大多数时候，它只是这样的纯文本。
有时，你需要显示一个 命令
或多个命令
dnf install my_stapler
dnf update my_pencil
dnf remove my_notepad
systemctl enable my_stapler
其他时候，你需要项目符号列表或编号列表
- 我相信你拿了我的订书机
- 说起来，我甚至找不到我的指南针
- 如果不行，请至少把我的铅笔还给我
-
我绝对需要它
-
我不知道你需要它
- 这是你那支坏了的铅笔
- 削它没用
你可能需要一个 admonition
提醒¶
Admonitions（也称为 out）是包含侧边内容而不会显着中断文档流的绝佳选择。Material for MkDocs 提供了几种类型的 admonitions，并允许包含和嵌套任意内容。
技巧
铅笔和订书机是老式的东西。
用法¶
Admonitions 遵循简单的语法：一个块以 !!! 开头，后跟用作类型限定符的关键字。块的内容跟在下一行，缩进四个空格。
注意
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo purus auctor massa, nec semper lorem quam in massa。
更改标题¶
默认情况下，标题将等于类型限定符的标题大小写。但是，可以通过在类型限定符后添加一个包含有效 Markdown（包括链接、格式等）的带引号字符串来更改它。
Phasellus posuere in sem ut cursus
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo purus auctor massa, nec semper lorem quam in massa。
很多时候，当一个命令有多个选项，或者你需要列出具体内容时，你可能想使用表格来标识事物。
| 工具 | 用途 | 附加信息 |
|---|---|---|
| 铅笔 | 书写或绘画 | 通常被笔取代 |
| 笔 | 书写或绘画 | 通常被触控笔取代 |
| 触控笔 | 在电子设备上书写或绘画 | 有时被键盘取代 |
| 键盘 | 在电子设备上书写或绘画 | 从未被取代 - 直到装满食物碎屑 |
| 记事本 | 做笔记 | 有时失灵的记忆的替代品 |
作者：Steven Spencer
贡献者：Wale Soyinka, Tony Guntharp