1439 words

3 min

Markdown 基本语法示例

0001-01-01

Guides

Markdown

Markdown 基本语法示例

基本语法

Markdown 是一种轻量级且易于使用的语法，用于为您的写作设计风格。

标题

文章内容较多时，可以用标题分段：

1
# 标题 1
2

3
## 标题 2
4

5
## 大标题
6

7
### 小标题

标题预览会打乱文章的结构，所以在此不展示。

粗斜体

1
_斜体文本_
2

3
**粗体文本**
4

5
**_粗斜体文本_**

预览：

斜体文本

粗体文本

粗斜体文本

链接

1
文字链接 [链接名称](http://链接网址)

预览：

文字链接链接名称 ↗

行内代码

1
这是一条 `单行代码`

预览：

这是一条 行内代码

代码块

1
```js
2
// calculate fibonacci
3
function fibonacci(n) {
4
  if (n <= 1) return 1
5
  return fibonacci(n - 1) + fibonacci(n - 2)
6
}
7
```

1
```rust {open=true}
2
// 11 行代码
3
#[derive(PartialEq,Debug)]
4
struct Bar(i32);
5
impl Bar {
6
    fn new(i: i32) -> Bar {
7
        Bar(i)
8
    }
9
    fn add_two(self) -> Bar {
10
        Bar(self.0 + 2)
11
    }
12
}
13
```

预览：

1
// calculate fibonacci
2
function fibonacci(n) {
3
  if (n <= 1) return 1
4
  return fibonacci(n - 1) + fibonacci(n - 2)
5
}

1
// 11 行代码
2
#[derive(PartialEq,Debug)]
3
struct Bar(i32);
4
impl Bar {
5
    fn new(i: i32) -> Bar {
6
        Bar(i)
7
    }
8
    fn add_two(self) -> Bar {
9
        Bar(self.0 + 2)
10
    }
11
}

1
一些不是代码的文本
2
可能是代码，也可能不是的文本

1
一些不是代码的文本

1
fn main() {
2
    let mut input_data  = String::new();
3
    std::io::stdin().read_line(&mut input_data).expect("read_line failed!");
4
    match input_data.trim().parse::<i32>() {
5
        Ok(data) => {
6
            match data {
7
                0..=10_0000 => println!("{}",f64::from(data)*0.1),
8
                10_0001..=20_0000 => println!("{}",10.0*0.1+(f64::from(data-10))*0.75), //
9
                20_0001..=40_0000 => println!("3ok"),
10
                40_0001..=60_0000 => println!(""),
11
                60_0001..=100_0000 => println!(""),
12
                _ => println!("{}", data)
13
            }
14
        }
15
        Err(_err) => {println!("{}",_err); }
16
    }
17
}
18
// 模拟 知识点 : match

行内公式

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

预览：

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

公式块

Hugo 已配置参考 https://gohugo.io/content-management/mathematics/ ↗

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

预览：

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

当前使用 KaTeX 作为数学公式插件，支持的语法请参考 KaTeX Supported Functions ↗。

图片

1
![哥伦比娅·几时](https://cdn.ftls.xyz/images/2026/03/哥伦比娅·几时.png)

预览：

删除线

1
~~删除线~~

预览：

~~删除线~~

列表

普通无序列表

预览：

1
2
3

普通有序列表

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

预览：

GPT-4
Claude Opus
LLaMa

列表里可以继续嵌套语法

引用

1
> 枪响，雷鸣，剑起。繁花血景。

预览：

枪响，雷鸣，剑起。繁花血景。

引用里也可以继续嵌套语法。

换行

markdown 分段落是需要空一行的。

1
如果不空行
2
就会在一段
3

4
第一段
5

6
第二段

预览：

如果不空行
就会在一段

第一段

第二段

分隔符

如果你有写分割线的习惯，可以新起一行输入三个减号--- 或者星号 ***。当前后都有段落时，请空出一行：

1
---

预览：

高级技巧

行内 HTML 元素

目前只支持部分段内 HTML 元素效果，包括 <kdb>  ，如

键位显示

1
使用 <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Del</kbd> 重启电脑

预览：

使用 Ctrl + Alt + Del 重启电脑

粗斜体

1
<b> Markdown 在此处同样适用，如 _加粗_ </b>

预览：

Markdown 在此处同样适用，如加粗

其他 HTML 写法

折叠块

1
<details><summary>点击展开</summary>它被隐藏了</details>

预览：

点击展开

它被隐藏了

表格

1
| 表头1 | 表头2 |
2
| ----- | ----- |
3
| 内容1 | 内容2 |

预览：

表头1	表头2
内容1	内容2

注释

1
在引用的地方使用 [^注释] 来添加注释。
2

3
然后在文档的结尾，添加注释的内容（会默认于文章结尾渲染之）。
4

5
[^注释]: 这里是注释的内容

预览：

在引用的地方使用 ¹ 来添加注释。

然后在文档的结尾，添加注释的内容（会默认于文章结尾渲染之）。

To-Do 列表

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

预览：

未完成的任务
已完成的任务

符号转义

如果你的描述中需要用到 markdown 的符号，比如 _ # * 等，但又不想它被转义，这时候可以在这些符号前加反斜杠，如 \_ \# \* 进行避免。

1
\_不想这里的文本变斜体\_
2

3
\*\*不想这里的文本被加粗\*\*

预览：

_不想这里的文本变斜体_

**不想这里的文本被加粗**

Hugo Shortcode

Hugo Shortcode 可以在 Markdown 中直接调用 Hugo 模板，详见 Components

这里是注释的内容 ↩︎

Markdown 基本语法示例

https://wolffyhtl.github.io/Hugo-Landscape-Next/posts/md/

Author

恐咖兵糖

Published at

0001-01-01

License

CC BY-NC-SA 4.0

TOC 说明

first