基本语法
Markdown 是一种轻量级且易于使用的语法,用于为您的写作设计风格。
标题
文章内容较多时,可以用标题分段:
# 标题 1
## 标题 2
## 大标题
### 小标题
标题预览会打乱文章的结构,所以在此不展示。
粗斜体
_斜体文本_
**粗体文本**
**_粗斜体文本_**
预览:
斜体文本
粗体文本
粗斜体文本
链接
文字链接 [链接名称](http://链接网址)
预览:
文字链接 链接名称
行内代码
这是一条 `单行代码`
预览:
这是一条 行内代码
代码块
```js
// calculate fibonacci
function fibonacci(n) {
if (n <= 1) return 1
return fibonacci(n - 1) + fibonacci(n - 2)
}
```
预览:
// calculate fibonacci
function fibonacci(n) {
if (n <= 1) return 1
return fibonacci(n - 1) + fibonacci(n - 2)
}
当前使用 shiki 作为代码高亮插件,支持的语言请参考 shiki / languages。
行内公式
这是一条行内公式 $e^{i\pi} + 1 = 0$
预览:
这是一条行内公式
公式块
$$
\hat{f}(\xi) = \int_{-\infty}^{\infty} f(x) e^{-2\pi i x \xi} \, dx
$$
预览:
当前使用 KaTeX 作为数学公式插件,支持的语法请参考 KaTeX Supported Functions。
图片
![CWorld](https://cravatar.cn/avatar/1ffe42aa45a6b1444a786b1f32dfa8aa?s=200)
预览:
删除线
~~删除线~~
预览:
删除线
列表
普通无序列表
- 1
- 2
- 3
预览:
- 1
- 2
- 3
普通有序列表
1. GPT-4
2. Claude Opus
3. LLaMa
预览:
- GPT-4
- Claude Opus
- LLaMa
列表里可以继续嵌套语法
引用
> 枪响,雷鸣,剑起。繁花血景。
预览:
枪响,雷鸣,剑起。繁花血景。
引用里也可以继续嵌套语法。
换行
markdown 分段落是需要空一行的。
如果不空行
就会在一段
第一段
第二段
预览:
如果不空行 就会在一段
第一段
第二段
分隔符
如果你有写分割线的习惯,可以新起一行输入三个减号---
或者星号 ***
。当前后都有段落时,请空出一行:
---
预览:
高级技巧
行内 HTML 元素
目前只支持部分段内 HTML 元素效果,包括 <kdb> <b> <i> <em> <sup> <sub> <br>
,如
键位显示
使用 <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Del</kbd> 重启电脑
预览:
使用 Ctrl + Alt + Del 重启电脑
粗斜体
<b> Markdown 在此处同样适用,如 _加粗_ </b>
预览:
Markdown 在此处同样适用,如 加粗
其他 HTML 写法
折叠块
<details><summary>点击展开</summary>它被隐藏了</details>
预览:
点击展开
它被隐藏了表格
| 表头1 | 表头2 |
| ----- | ----- |
| 内容1 | 内容2 |
预览:
表头1 | 表头2 |
---|---|
内容1 | 内容2 |
注释
在引用的地方使用 [^注释] 来添加注释。
然后在文档的结尾,添加注释的内容(会默认于文章结尾渲染之)。
[^注释]: 这里是注释的内容
预览:
在引用的地方使用 1 来添加注释。
然后在文档的结尾,添加注释的内容(会默认于文章结尾渲染之)。
To-Do 列表
- [ ] 未完成的任务
- [x] 已完成的任务
预览:
- 未完成的任务
- 已完成的任务
特别引用块
> [!NOTE]
> 在浏览内容时,用户也应该知道的有用信息。
> [!TIP]
> 可以更好或更容易地完成事情的有用建议。
> [!IMPORTANT]
> 用户需要知道的关键信息。
> [!WARNING]
> 需要用户立即关注以避免问题的紧急信息。
> [!CAUTION]
> 就某些行为的风险或负面结果提供建议。
预览:
NOTE
在浏览内容时,用户也应该知道的有用信息。
TIP
可以更好或更容易地完成事情的有用建议。
IMPORTANT
用户需要知道的关键信息。
WARNING
需要用户立即关注以避免问题的紧急信息。
CAUTION
就某些行为的风险或负面结果提供建议。
符号转义
如果你的描述中需要用到 markdown 的符号,比如 _ # * 等,但又不想它被转义,这时候可以在这些符号前加反斜杠,如 \_
\#
\*
进行避免。
\_不想这里的文本变斜体\_
\*\*不想这里的文本被加粗\*\*
预览:
_不想这里的文本变斜体_
**不想这里的文本被加粗**
内嵌 Astro 组件
源代码位于 src/components
目录下,一般不用于写作,而是用于页面的客制化。
你可以仿照现有组件的写法,自行添加新的组件。
Footnotes
这里是注释的内容 ↩