标题#

1
# 一级标题
2
## 二级标题
3
### 三级标题

三级标题#

段落和格式#

段落之间用空行分隔。

第二段。斜体，粗体，等宽字体。

列表#

1
- 这个
2
- 那个
3
- 另一个

1
1. 第一项
2
2. 第二项
3
3. 第三项

引用#

1
> 引用内容
2
> 是这样写的。
3
>
4
> 它们可以跨越多行，
5
> 如果你愿意的话。

引用内容 是这样写的。

它们可以跨越多行， 如果你愿意的话。

使用 3 个破折号表示 em 破折号。使用 2 个破折号表示范围（例如，“第 12—14 章都在”）。三个点 … 会被转换为省略号。支持 Unicode。☺

代码块#

1
    # 让我重申一下 ...
2
    for i in 1 .. 10 { do-something(i) }

如您所料，缩进 4 个空格。顺便说一下，您可以使用分隔块，如果您愿意：

1
define foobar() {
2
    print "Welcome to flavor country!";
3
}

（这使得复制和粘贴更容易）。您可以选择标记分隔块，以便 Pandoc 进行语法高亮：

1
import time
2
# 快速，数到十！
3
for i in range(10):
4
    # (但不要太快)
5
    time.sleep(0.5)
6
    print i

嵌套列表#

现在是一个嵌套列表：

1. 首先，获取这些配料：

   • 胡萝卜
   • 芹菜
   • 小扁豆

2. 烧一些水。

3. 把所有东西都倒进锅里，然后按照这个算法操作：

   1
    找到木勺
   2
    揭开锅盖
   3
    搅拌
   4
    盖上锅盖
   5
    将木勺 precariously 地放在锅柄上
   6
    等待 10 分钟
   7
    转到第一步（或者完成时关闭炉子）
   

   不要撞到木勺，否则它会掉下来。

再次注意文本如何总是对齐在 4 空格缩进（包括上面继续第 3 项的最后一行）。

链接#

这里有一个 网站 链接，一个 本地文档 链接，以及一个 当前文档的章节标题 链接。这里有一个脚注 ¹。

表格#

表格可以像这样：

size material color

9 leather brown 10 hemp canvas natural 11 glass transparent

Table: Shoes, their sizes, and what they’re made of

(The above is the caption for the table.) Pandoc also supports multi-line tables:

keyword text

red Sunsets, apples, and other red or reddish things.

green Leaves, grass, frogs and other things it’s not easy being.

水平线#

接下来是一条水平线。

定义列表#

这里有一个定义列表：

apples : 适合做苹果酱。 oranges : 柑橘类水果！ tomatoes : tomatoe 中没有 “e”。

同样，文本缩进 4 个空格。（在每个术语/定义对之间放一个空行可以让内容更加分散）。

行块#

这里有一个”行块”：

| 第一行 | 第二行 | 第三行

图片#

图片可以像这样指定：

1
![示例图片](./demo-banner.png "示例性图片")

数学公式#

行内数学公式：$\omega = d\phi / dt$。显示数学公式应该有自己的一行，并用双美元符号括起来：

$I = \int \rho R^{2} dV$

另外请注意，您可以反斜杠转义任何您希望字面显示的标点字符，例如：`foo`、*bar* 等。

GitHub 仓库卡片#

您可以添加链接到 GitHub 仓库的动态卡片，页面加载时，仓库信息会从 GitHub API 获取。

使用代码 ::github{repo="<owner>/<repo>"} 创建 GitHub 仓库卡片。

1
::github{repo="saicaca/fuwari"}

提示框 (Admonitions)#

支持以下类型的提示框：note tip important warning caution

NOTE

强调用户应该注意的信息，即使在浏览时也应该注意。

TIP

帮助用户更成功的可选信息。

IMPORTANT

用户成功所需的关键信息。

WARNING

由于潜在风险，需要立即引起用户注意的关键内容。

CAUTION

某个操作的负面潜在后果。

1
:::note
2
强调用户应该注意的信息，即使在浏览时也应该注意。
3
:::
4

5
:::tip
6
帮助用户更成功的可选信息。
7
:::

1
:::note[我的自定义标题]
2
这是一个带有自定义标题的提示。
3
:::

1
> [!NOTE]
2
> GitHub 语法也受支持。
3

4
> [!TIP]
5
> GitHub 语法也受支持。

剧透#

您可以在文本中添加剧透内容，文本也支持 Markdown 语法。

内容 被隐藏的内容 哦!

1
内容 :spoiler[被隐藏的内容 **哦**]!

YouTube#

Bilibili#

语法高亮#

语法高亮

1
console.log('这段代码有语法高亮！')

1
ANSI 颜色:
2
- 常规: 红色 绿色 黄色 蓝色 洋红色 青色
3
- 粗体:    红色 绿色 黄色 蓝色 洋红色 青色
4
- 暗淡:  红色 绿色 黄色 蓝色 洋红色 青色
5

6
256 色（显示颜色 160-177）：
7
160 161 162 163 164 165
8
166 167 168 169 170 171
9
172 173 174 175 176 177
10

11
全 RGB 颜色：
12
ForestGreen - RGB(34, 139, 34)
13

14
文本格式：粗体 暗淡 斜体 下划线

编辑器和终端框架#

编辑器和终端框架

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
+这是一个实际的 diff 文件
5
-所有内容将保持不变
6
也不会删除任何空白

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
// 带 wrap 的示例
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
}

可折叠部分#

可折叠部分

5 collapsed lines
1
// 所有这些样板设置代码将被折叠
2
import { someBoilerplateEngine } from '@example/some-boilerplate'
3
import { evenMoreBoilerplate } from '@example/even-more-boilerplate'
4

5
const engine = someBoilerplateEngine(evenMoreBoilerplate())
6

7
// 这部分代码默认可见
8
engine.doSomething(1, 2, 3, calcFn)
9

10
function calcFn() {
11
  // 您可以有多个折叠部分
3 collapsed lines
12
  const a = 1
13
  const b = 2
14
  const c = a + b
15

16
  // 这将保持可见
17
  console.log(`计算结果：${a} + ${b} = ${c}`)
18
  return c
19
}
20

4 collapsed lines
21
// 所有这些直到代码块末尾的代码将再次折叠
22
engine.closeConnection()
23
engine.freeMemory()
24
engine.shutdown({ reason: '示例样板代码结束' })

行号#

行号

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

// 这个代码块的行号被禁用
console.log('你好？')
console.log('对不起，你知道我在第几行吗？')

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