Back

Markdown 语法支持Markdown 语法支持

基本语法

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$

预览:

这是一条行内公式 eiπ+1=0e^{i\pi} + 1 = 0

公式块

$$
\hat{f}(\xi) = \int_{-\infty}^{\infty} f(x) e^{-2\pi i x \xi} \, dx
$$

预览:

f^(ξ)=f(x)e2πixξdx\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)

预览:

CWorld

删除线

~~删除线~~

预览:

删除线

列表

普通无序列表

- 1
- 2
- 3

预览:

  • 1
  • 2
  • 3

普通有序列表

1. GPT-4
2. Claude Opus
3. LLaMa

预览:

  1. GPT-4
  2. Claude Opus
  3. 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

  1. 这里是注释的内容

Markdown 语法支持
https://theme-astro-pure.vercel.app/blog/markdown-zh
Author CWorld / Arthals
Update date July 26, 2024
Copyright CC BY-NC-SA 4.0
Comment seems to stuck. Try to refresh?✨