Fuwari Markdown 语法参考指南

本文由ai撰写

基础语法 (Basic Syntax)#

标题 (Headings)#

使用 # 符号表示标题层级。

1
# 一级标题 (H1)
2
## 二级标题 (H2)
3
### 三级标题 (H3)
4
#### 四级标题 (H4)
5
##### 五级标题 (H5)
6
###### 六级标题 (H6)

文本格式 (Text Formatting)#

支持加粗、斜体、删除线和行内代码。

语法	代码示例	渲染效果
加粗	`Bold`	Bold
斜体	`Italic`	Italic
~~删除线~~	`~~Strikethrough~~`	~~Strikethrough~~
`行内代码`	`Inline Code`	`Inline Code`

列表 (Lists)#

无序列表#

1
- 项目 1
2
- 项目 2
3
  - 子项目 A
4
  - 子项目 B

渲染效果：

项目 1
项目 2
- 子项目 A
- 子项目 B

有序列表#

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

渲染效果：

第一步
第二步
第三步

引用 (Blockquotes)#

使用 > 符号进行引用，支持嵌套。

1
> 这是一个引用块。
2
>
3
> > 这是一个嵌套的引用块。

渲染效果：

这是一个引用块。

这是一个嵌套的引用块。

链接与图片 (Links & Images)#

1
[Fuwari GitHub](https://github.com/saicaca/fuwari)
2
![Fuwari Banner](https://raw.githubusercontent.com/saicaca/fuwari/main/public/og.png)

渲染效果： Fuwari GitHub Fuwari Banner

扩展语法 (Extended Syntax)#

表格 (Tables)#

使用 | 和 - 创建表格，支持对齐方式。

1
| 左对齐 | 居中对齐 | 右对齐 |
2
| :----- | :----: | -----: |
3
| 单元格 | 单元格 | 单元格 |
4
| 内容 A | 内容 B | 内容 C |

渲染效果：

左对齐	居中对齐	右对齐
单元格	单元格	单元格
内容 A	内容 B	内容 C

任务列表 (Task Lists)#

1
- [x] 已完成任务
2
- [ ] 未完成任务

渲染效果：

已完成任务
未完成任务

脚注 (Footnotes)#

1
这是一个带有脚注的句子[^1]。
2

3
[^1]: 这是脚注的内容。

渲染效果： 这是一个带有脚注的句子¹。

高级功能 (Advanced Features)#

Fuwari 集成了许多强大的插件，提供更丰富的展示效果。

代码块增强 (Expressive Code)#

支持语法高亮、文件名显示、行号及行高亮。

1
```js title="example.js" {1, 3-4}
2
const greeting = "Hello";
3
console.log(greeting);
4
// 这一行被高亮
5
const add = (a, b) => a + b;
6
```

渲染效果：

1
const greeting = "Hello";
2
console.log(greeting);
3
// 这一行被高亮
4
const add = (a, b) => a + b;

数学公式 (Math)#

支持 LaTeX 数学公式渲染（基于 Katex）。

行内公式： $E = mc^2$

块级公式：

1
$$
2
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
3
$$

渲染效果：

\sum_{i=1}^{n} i = \frac{n(n+1)}{2}

提示块 (Admonitions)#

支持 GitHub 风格的警告块和自定义指令。

GitHub 风格#

1
> [!NOTE]
2
> 这是一个包含有用信息的提示块。
3

4
> [!WARNING]
5
> 这是一个警告块，请注意。

渲染效果：

NOTE
这是一个包含有用信息的提示块。

WARNING
这是一个警告块，请注意。

指令风格 (Directives)#

支持 note, tip, warning 等类型。

1
:::tip[小技巧]
2
这是使用 `:::` 指令创建的提示块，可以自定义标题。
3
:::
4

5

6
**渲染效果：**
7

8
:::tip[小技巧]
9
这是使用 `:::` 指令创建的提示块，可以自定义标题。
10
:::
11

12
### GitHub 仓库卡片
13

14
展示 GitHub 仓库信息的卡片组件。
15

16
```markdown
17
::github{repo="saicaca/fuwari"}

渲染效果：

saicaca

fuwari

Waiting for api.github.com...

00K

Waiting...

折叠详情 (Details)#

使用 HTML <details> 标签创建可折叠内容。

1
<details>
2
<summary>点击展开查看更多</summary>
3

4
这里是隐藏的详细内容。
5
可以包含 **Markdown** 格式。
6
</details>

渲染效果：

点击展开查看更多

这里是隐藏的详细内容。可以包含 Markdown 格式。

希望这份指南能帮助你更好地使用 Fuwari 撰写博客！

这是脚注的内容。 ↩

基础语法 (Basic Syntax)#

标题 (Headings)#

文本格式 (Text Formatting)#

列表 (Lists)#

无序列表#

有序列表#

引用 (Blockquotes)#

链接与图片 (Links & Images)#

扩展语法 (Extended Syntax)#

表格 (Tables)#

任务列表 (Task Lists)#

脚注 (Footnotes)#

高级功能 (Advanced Features)#

代码块增强 (Expressive Code)#

数学公式 (Math)#

提示块 (Admonitions)#

GitHub 风格#

指令风格 (Directives)#

折叠详情 (Details)#

Footnotes#