# 换行

markdown 中的换行与在其它地方键入文字不同,在使用 markdown 时,两行内容之间空了一行,表示在这两行中间添加空格。

e.g.e.g.(节选自《共产党宣言》)(德) 卡・马克思 弗・恩格斯 著

一个幽灵,共产主义的幽灵,在欧洲游荡。为了对这个幽灵进行神圣的围剿,旧欧洲的一切势力,教皇和沙皇、梅特涅和基佐、法国的激进派和德国的警察,都联合起来了。
有哪一个反对党不被它的当政的敌人骂为共产党呢?又有哪一个反对党不拿共产主义这个罪名去回敬更进步的反对党人和自己的反动敌人呢?
从这一事实中可以得出两个结论:
共产主义已经被欧洲的一切势力公认为一种势力;
现在是共产党人向全世界公开说明自己的观点、自己的目的、自己的意图并且拿党自己的宣言来反驳关于共产主义幽灵的神话的时候了。
为了这个目的,各国共产党人集会于伦敦,拟定了如下的宣言,用英文、法文、德文、意大利文、佛拉芒文和丹麦文公布于世。

显示效果:(可用鼠标选中这两行文字的方式观察换行情况)

一个幽灵,共产主义的幽灵,在欧洲游荡。为了对这个幽灵进行神圣的围剿,旧欧洲的一切势力,教皇和沙皇、梅特涅和基佐、法国的激进派和德国的警察,都联合起来了。

有哪一个反对党不被它的当政的敌人骂为共产党呢?又有哪一个反对党不拿共产主义这个罪名去回敬更进步的反对党人和自己的反动敌人呢?

从这一事实中可以得出两个结论:

共产主义已经被欧洲的一切势力公认为一种势力;

现在是共产党人向全世界公开说明自己的观点、自己的目的、自己的意图并且拿党自己的宣言来反驳关于共产主义幽灵的神话的时候了。

为了这个目的,各国共产党人集会于伦敦,拟定了如下的宣言,用英文、法文、德文、意大利文、佛拉芒文和丹麦文公布于世。

# 分割线

共有三种: ***---___

显示效果如下:

***
---
___



正如你所见,在大多数渲染器上,这三种分割线显示的效果是相同的。

# 标题

因为本博客文章的题目都在 Front Matter 中规定,其中的 title 字段即为文章的标题。例如本文的 Front Matter 为:

---
title: markdown 快速上手 // 文章标题
date: 2025-03-31 23:45:22 // 文章创建的时间
categories: Others // 文章在博客中的分类
tags:   // 文章的标签
- 教程
---

而读者说的就是你在本站发评论(一般来说)又不需要大标题,综上所述这里的标题一般指的是文章中的小标题。

若要建立第xx 级标题,就在该标题前加一个 # ,且在 # 后要加一个空格。

e.g.e.g.

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
……

显示效果:

# 一级标题

# 二级标题

# 三级标题

# 四级标题


# 列表

不带编号的列表:

在本段文字前加 - 和一个空格。

带编号的列表:

在要添加序号的文字前加 阿拉伯数字. 和一个空格。

e.g.e.g.

共产党宣言
马克思 恩格斯
(1848年)
- 1872 年德文版序言
- 1882 年俄文版序言
- 1883 年德文版序言
- 1888 年英文版序言
- 1890 年德文版序言
- 1892 年波兰文版序言
- 1893 年意大利文版序言
共产党宣言
1. 资产者和无产者
2. 无产者和共产党人
3. 社会主义的和共产主义的文献
4. 共产党人对各种反对党派的态度
5. 人名索引

显示效果:

共产党宣言

马克思 恩格斯

(1848 年)

  • 1872 年德文版序言
  • 1882 年俄文版序言
  • 1883 年德文版序言
  • 1888 年英文版序言
  • 1890 年德文版序言
  • 1892 年波兰文版序言
  • 1893 年意大利文版序言

共产党宣言

  1. 资产者和无产者
  2. 无产者和共产党人
  3. 社会主义的和共产主义的文献
  4. 共产党人对各种反对党派的态度
  5. 人名索引

注意

  1. 列表时无须再使用语法换行。若在两个列表之间插入空行则会控制行距。
- 1872 年德文版序言
- 1882 年俄文版序言
- 1883 年德文版序言
- 1888 年英文版序言
- 1890 年德文版序言
- 1892 年波兰文版序言
- 1893 年意大利文版序言

显示效果:

  • 1872 年德文版序言

  • 1882 年俄文版序言

  • 1883 年德文版序言

  • 1888 年英文版序言

  • 1890 年德文版序言

  • 1892 年波兰文版序言

  • 1893 年意大利文版序言

  1. 带编号的列表默认从最小的编号向最大的编号递增,而不随标注的序号改变。如:
共产党宣言
1. 资产者和无产者
2. 无产者和共产党人
3. 社会主义的和共产主义的文献
4. 共产党人对各种反对党派的态度
0. 人名索引

显示出来的是:

共产党宣言

  1. 资产者和无产者
  2. 无产者和共产党人
  3. 社会主义的和共产主义的文献
  4. 共产党人对各种反对党派的态度
  5. 人名索引

若要构建多级列表,则在第 xx(x>1)(x>1) 列表符号前加至少两个空格表示缩进,个人建议直接按一次 tab 键。

e.g.e.g.

- 多路复用技术
    - 时分多路复用
        - 同步时分复用
        - 异步时分复用
    - 频分多路复用
    - 波分多路复用
    - 码分多路复用
  • 多路复用技术
    • 时分多路复用
      • 同步时分复用
      • 异步时分复用
    • 频分多路复用
    • 波分多路复用
    • 码分多路复用

# 引用与代码块

# 引用

在文字两端加 ` 来表示引用。

若引用内容中有 ` 字符,则在该文字两端加 ``

若引用内容中有 `` ,则使用 ``` 来引用;

……

以此类推。禁止套娃

e.g.e.g.

`引用`
``禁止` 引用 ```
```禁止 ``禁止引用`` ```

显示效果:禁止套娃

引用

禁止`引用`

禁止 `` 禁止 `引用` ``

# 代码块

与引用类似,将大段文字的前后各加入一行 ``` 即可形成代码块。如果中间是使用某种编程语言写成的代码,那么通常还需要在第一个 ``` 后写上全小写的语言名称。

e.g.e.g.

```cpp
#include <bits/stdc++.h>
int main(){
    std::cout << "Hello World! " << std::endl;
    return 0;
}
```

显示效果:

#include <bits/stdc++.h>
int main(){
    std::cout << "Hello World! " << std::endl;
    return 0;
}

在引用 markdown 代码块时,难免会遇见代码块中含有 ``` 的情况。与引用的解决方式类似,用更多的 ` 来表示代码块。比如上面的示例,我在 markdown 编辑器中是这么写的:

````markdown
```cpp
#include <bits/stdc++.h>
int main(){
    std::cout << "Hello World! " << std::endl;
    return 0;
}
```
````

所以你猜这篇文章套了几层 ` 😠

# 基本的文字强调(斜体与加粗)

在要强调的文字前加 * 来对文字进行加粗与强调。

  • *x* 表示把 x 渲染成斜体。
  • **x** 表示把 x 加粗。
  • ***x*** 表示把 x 加粗并渲染成斜体。

e.g.e.g.

*师爷,高*
**县长,硬**
***黄老爷又高又硬***

师爷,高

县长,硬

黄老爷又高又硬

# 插入表格

markdown 中插入表格相当繁琐。格式如下:

% 第二行表示表头与正文的分割,本行上面是表头,下面是正文
% 如果不希望表格有表头,那么将|---|放在表格的第一行
|我是表头1|我是表头2|我是表头3|
|---|---|---|                
|我是内容1|我是内容2|我是内容3|
|我是内容4|我是内容5|我是内容6|

显示效果:

我是表头 1 我是表头 2 我是表头 3
我是内容 1 我是内容 2 我是内容 3
我是内容 4 我是内容 5 我是内容 6

# 插入链接与图片

# 链接

语法:

[希望显示的文字](网站url)

例如一个超链接到本站首页的文字:

[…ようこそ。Mr.Hate の世界へ](https://mr-hate.github.io)

显示效果:

… ようこそ。Mr.Hate の世界へ

# 图片

与链接类似。

语法:

![图片名称(可留空)](图片url或者路径 “图片下面标注的文字”)

例如在此插入一张随机二次元图片:

![我超二刺猿](https://t.alcy.cc/ycy "傻逼二次元受不了了")

我超二刺猿

# 使用 KaTeX\KaTeX 等渲染器将文本渲染成数学公式

在数学表达式两侧加 $ 符号即可。

若想用多行表示一个公式,则在首行之前和末行之后各加一行 $$

e.g.e.g. 其实这一行就是渲染出来的效果,个人比较喜欢这种字体

笛卡尔心形曲线的极坐标形式:
$r=a(1-cosθ)$
一个矩阵:
$$
\begin{pmatrix}
    a&b\\
    c&d\\
\end{pmatrix}
$$
一个复变函数积分:
$$
\oint \limits_{C} \frac{dz}{(z-z_{0})^{n+1}}
$$

显示效果:

笛卡尔心形曲线的极坐标形式:

r=a(1cosθ)r=a(1-cosθ)

一个矩阵:

(abcd)\begin{pmatrix} a&b\\ c&d\\ \end{pmatrix}

一个复变函数积分:

Cdz(zz0)n+1={2πi,n=00,n0\oint \limits_{C} \frac{dz}{(z-z_{0})^{n+1}}= \begin{cases} 2 \pi i,n = 0 \\ 0, n \neq 0 \end{cases}


LaTeX\LaTeX 能表示的式子还有很多,参见 LaTeX\LaTeX 使用文档KaTeX\KaTeX 数学公式大全

# 结语

OK 大概就是这样。相信大家已经初步掌握 markdown 语法了,可以更好的在本站发表自己的见解了。

# 参见(更多有关 markdown 的内容与本文的参考文献)

  • 学长写的 markdown 光速上手

  • Github 上的 中文文案排版指北

更新于 阅读次数