0%

Markdown基本语法与示例

发表于 更新于 分类于
本文字数： 4.1k 阅读时长 ≈ 4 分钟

Markdown是一种纯文本格式标记语言，它通过简单的标记语法实现了格式排版，且易学、易读、易写，因此非常流行。本文及本博客的文章均使用Markdown语法书写。

0 简单介绍

优点：

  1. 纯文本，编辑效果一致，可以无视排版，专心写作。
  2. 操作简单，例如新增标题只需要在标题内容前加#即可。

缺点：

  1. 需要记一些语法，但非常简单。
  2. 有些平台不支持Markdown编辑模式。

常用编辑器：

  • Typora（Windows，大力推荐，与其他编辑器不同的是编辑效果即排版效果，无需左右分栏对照）
  • Simplenote（IOS，免费，支持中文、云端存储、iPad）

1 标题

标题文字前面加#即可，注意#与文字之间要有空格。几级标题加几个#，共有六级标题。例如本段落标题的源码为：

1
## 1、标题

2 字体

2.1 粗体

使用**或__包在文字两端。例如：**粗体**效果为粗体。

2.2 斜体

使用*或_包在文字两端。例如：*斜体*效果为斜体。

当然，粗体斜体可以嵌套使用，例如：***粗体+斜体***效果为粗体+斜体。

2.3 高亮

使用==包在文字两端。例如：==高亮==效果为==高亮==。

Typora需要设置开启高亮。并且如你所见，核心舱不支持高亮。

2.4 删除线

使用~~包在文字两端。例如：~~删除线~~效果为删除线。

3 引用

引用文字前面加>即可。引用可以嵌套，使用>>、>>>……以此类推。

例如：

1
2
3
4
5
6
7
> 一级引用
>> 二级引用
>>>>> 五级引用
> > >
> 回退到三级引用
>
> 回退到一级引用

效果为

一级引用

二级引用

五级引用

回退到三级引用

回退到一级引用

4 分割线

三个或三个以上的-或*（Typora还支持+）。

例如：

1
2
3
4
---
-----
***
*****

效果为

（一毛一样）

5 HTML

直接输入就行，会自动渲染。例如：<b>HTML加粗</b>效果为HTML加粗。再例如：

1
<font face="黑体" size="5" color="red">HTML内容</font>

效果为

HTML内容

甚至可以来段更复杂的：

1
2
3
4
5
6
7
8
<form>
用户名: <input type="text" name="user"><br>
密　码: <input type="password" name="pwd"><br>
性　别: <input type="radio" name="sex" value="男" checked>男&nbsp;
    <input type="radio" name="sex" value="女">女<br>
<button type="button" name="Submit" Onclick="alert('成功')">提交</button>
<button type="reset" name="Reset">重置</button>
</form>

效果为

用户名:
密　码:
性　别: 男  女

（点一下试试）

6 超链接

使用[name](link "tooltip")表示超链接，其中name是超链接文字，link是超链接地址，tooltip是悬浮文字提示（可选）。

例如：

1
[卡洛的核心舱](https://corecabin.cn "你好")

效果为

卡洛的核心舱

还可以用html的a标签，例如：

1
<a href="https://corecabin.cn" target="_blank">卡洛的核心舱</a>

效果为

卡洛的核心舱

其中target="_blank"表示在新标签打开。

当遇到纯链接时，可以用<和>将其包起来，防止后面的文字被解析，例如：

1
2
<https://corecabin.cn/>这是包起来的效果
https://corecabin.cn/这是不包起来的效果

https://corecabin.cn/这是包起来的效果
https://corecabin.cn/这是不包起来的效果

7 图片

使用![text](link "tooltip")表示图片，其中text是显示在图片下方的说明，link是图片路径，可以用相对路径、绝对路径、互联网路径，tooltip是悬浮文字提示（可选）。

例如（互联网路径）：

1
![中国空间站](https://cdn.jsdelivr.net/gh/kaluojushi/Corecabin-Picbed/img/kongjianzhan.jpg "天和核心舱")

效果为

中国空间站

以及套娃设置图片的超链接，例如（相对路径）：

1
[![卡洛的核心舱](/img/corecabin-textlogo-bgcolor.jpg)](https://corecabin.cn)

效果为：

卡洛的核心舱

注意以上情况在当前主题下可能会遇到图片文字说明的显示bug。

8 列表

8.1 无序列表

文字前面加-或*或+即可，注意符号与文字之间要有空格。

例如：

1
2
3
- 无序列表1
* 无序列表2
+ 无序列表3

效果为

  • 无序列表1
  • 无序列表2
  • 无序列表3

8.2 有序列表

文字前面加数字与.即可，注意符号与文字之间要有空格。注意显示效果与实际输入数字无关，而与当前次序有关。

例如：

1
2
3
1. 第一点
2. 第二点
4. 大概是第四点？

效果为

  1. 第一点
  2. 第二点
  3. 大概是第四点？

8.3 列表嵌套

不同级列表之间通过缩进即可嵌套，例如：

1
2
3
4
5
6
- 一级无序
	+ 二级无序1
	+ 二级无序2
1. 一级有序
	1. 二级有序
		+ 三级无序

效果为

  • 一级无序
    • 二级无序1
    • 二级无序2
  1. 一级有序
    1. 二级有序
      • 三级无序

9 代码

9.1 行内代码

使用“`”包在代码两端。例如：

1
`javascript`

效果为

javascript

本文也大量用到行内代码表示文字高亮。

9.2 代码块

使用3个“`”包在代码两端，第一行可以加入代码语言，例如：

1
2
3
4
5
6
7
8
9
10
```javascript
function fact(num) {
	if (num === 1) {
		return 1;
	}
	else {
		return num * fact(num - 1);
	}
}
```

效果为

1
2
3
4
5
6
7
8
function fact(num) {
	if (num === 1) {
		return 1;
	}
	else {
		return num * fact(num - 1);
	}
}

本文也大量用到代码块表示Markdown示例。

10 数学公式

Markdown支持LaTeX公式。行内公式用$包在公式两端（Typora需要设置开启），公式块用$$包在公式两端，例如：

1
2
3
4
当 $a \ne 0$, 此方程式有两个解 $ax^2 + bx + c = 0$，他们是
$$
x = {-b \pm \sqrt{b^2-4ac} \over 2a}.
$$

效果为

当 $a \ne 0$​, 此方程式有两个解 $ax^2 + bx + c = 0$​，他们是

更多公式相关见《LaTeX数学公式手册》。

11 任务列表（Todo List）

文字前面加- [ ]或- [x]即可，空格表示未完成，x表示已完成。

例如：

1
2
3
4
5
6
- [x] 甜甜圈
- [x] 珍珠奶茶
- [ ] 方便面
- [x] 火锅
- [ ] 米饭
- [ ] 大盘鸡

效果为

  • 甜甜圈
  • 珍珠奶茶
  • 方便面
  • 火锅
  • 米饭
  • 大盘鸡

12 表格

语法为：

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

第二行用来分割表头与内容。-的个数有一个就行，此处多加了几个。

文字默认居左。-的两边加:表示该列居中，-的右边加:表示该列居右。

例如：

1
2
3
4
5
姓名（居左）|年级（居中）|年龄（居右）
-----|:-----:|-----:
张三|大三|21
李四|大一|18
王五|研二|24

效果为

姓名（居左） 年级（居中） 年龄（居右）
张三 大三 21
李四 大一 18
王五 研二 24

13 转义字符

在输入特殊符号，尤其是Markdown和HTML中的部分符号时，可以使用转义字符。

13.1 Markdown转义字符

使用\置于符号前。

例如输入*你好*会显示你好，输入\*你好\*效果为*你好*。

具体如下：

字符 含义 转义字符
\ 反斜杠 \\
` 反引号 \`
* 星号 \*
_ 下划线 \_
{} 花括号 \{\}
[] 方括号 \[\]
() 小括号 \(\)
# 井号 \#
+ 加号 \+
- 减号 \-
. 英文句点 \.
! 英文感叹号 \!

13.2 HTML转义字符

直接输入HTML转义字符，具体如下：

显示结果 描述 输入 实体编号
空格 &nbsp; &#160;
< 小于号 &lt; &#60;
> 大于号 &gt; &#62;
& 和号 &amp; &#38;
“ 引号 &quot; &#34;
‘ 撇号 &apos;(IE不支持) &#39;
￠ 分 &cent; &#162;
£ 镑 &pound; &#163;
¥ 日圆 &yen; &#165;
§ 节 &sect; &#167;
© 版权 &copy; &#169;
® 注册商标 &reg; &#174;
× 乘号 &times; &#215;
÷ 除号 &divide; &#247;