Markdown教程

Markdown教程

本文最初发表于:http://modanqi.com/2020/05/21/Markdown笔记/，转载请保留出处及本声明

参考菜鸟教程：https://www.runoob.com/markdown/

Markdown标题

方法一

使用=和-

一级标题
=======
二级标题
-----------

效果如下：

一级标题

二级标题

方法二

使用#号标记

#一级标题
##二级标题
###三级标题
####四级标题
#####五级标题
######六级标题

效果如下：

Markdown段落

• 使用两个以上的空格加上回车
• 段落后使用一个空行
  

字体

*斜体文字*
*粗体文字*
*粗斜体文字*

或者

_斜体文字_
_粗体文字_
_粗斜体文字_

效果如下：

斜体文字
粗体文字
粗斜体文字

分割线

一行中用三个以上星号（*）、减号（-）、底线（_）
注意： 行内不能有其他东西，符号间间可有空格

***
* * *
*********
—
- - -
---------
_ _ _
_________

效果如下:

---

删除线

文字两端加上两个波浪线

~~删除~~

效果如下：

删除

下划线

通过HTML的<u>标签实现

<u>带下划线文字</u>

效果如下:
带下划线文字

脚注

脚注是对文本的补充说明，注意脚注自动搬运至文章末尾，点击脚注后链接可直接跳转

test[^脚注名]
[^脚注名]:解释内容

效果如下:

test¹

列表

无序列表

使用星号（*）、加好（+）、减号（-）作为列表标记，三者效果相同

* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项

- 第一项
- 第二项
- 第三项

效果如下：

• 第一项
• 第二项
• 第三项

有序列表

使用数字并加上.号表示

1.第一项
2.第二项
3.第三项

效果如下:

1.第一项
2.第二项
3.第三项

列表嵌套

只需在子列表的选项添加四个空格即可

+ 第一项
  + 第一项嵌套的第一个元素
  + 第一项嵌套的第二个元素
+ 第二项
  + 第二项嵌套的第一个元素
  + 第二项嵌套的第二个元素

效果如下：

• 第一项：
  • 第一项嵌套的第一个元素
  • 第一项嵌套的第二个元素
• 第二项
  • 第二项嵌套的第一个元素
  • 第二项嵌套的第二个元素

区块

段落开头使用>符号，然后紧跟一个空格
> 区块引用
> 区别引用
效果如下

区块引用
区块引用

区块引用的嵌套

一个>号是最外层，两个>号是第一层嵌套，以此类推
> 最外层
>> 第一层嵌套
>>> 第二层嵌套

效果如下：

最外层

第一层嵌套

第三层嵌套

区块中使用列表

区块中使用列表

• 第一项
• 第二项
• 第三项

列表中使用区块

+ 第一项
  >列表内容
+ 第二项
  >列表内容

效果如下：

• 第一项

  列表内容

• 第二项

  列表内容

代码

段落上的一个函数或片段的代码可以用反引号（`）包起来

`prinf(“hello”)`

效果如下:
printf("hello")函数
####代码区块
``` 包裹一段代码,也可指定一种语言
效果如下:

```java
public class Instance{
public static void main{
System.out.println(“Hello”);
}
}
```

效果如下:

public class Instance{
public static void main{
   System.out.println("Hello");
}
}

链接

这是一个链接[my blog](http://www.modanqi.com)

效果如下：

这是一个链接my blog

直接使用链接

<http://www.modanqi.com>

效果如下:

http://www.modanqi.com

高级链接

通过变量来设置一个链接，变量赋值在文档的末尾

这个链接使用q作为网址变量[Google][q]
然后在文档的结尾为变量赋值（网址）
[q]:http://www.google.com

效果如下：

这个链接使用q作为网址变量[Google][q]
然后在文档的结尾为变量赋值（网址）
[q]:http://www.google.com

图片

语法格式:


• 开头一个感叹号
• 接着一个方块号，放上图片的替代文字
• 接着一个普通括号，放上图片的网址，最后还可以用引号包住并加上选择性的title属性的文字
  

效果如下:
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-QAvkqWci-1590134612880)(https://i-blog.csdnimg.cn/blog_migrate/c5d81b8680dc3c5cbe84f9a4e942cce3.png “示例”)]

• 也可向网址那样对图片使用变量
• Markdown还无法指定图片的高度与宽度，如果需要，可以使用普通的<img>标签

<img src=“https://i-blog.csdnimg.cn/blog_migrate/c5d81b8680dc3c5cbe84f9a4e942cce3.png” width=50%>
<img src=“https://i-blog.csdnimg.cn/blog_migrate/c5d81b8680dc3c5cbe84f9a4e942cce3.png” width=25%>

效果如下:

表格

制作表格使用|来分隔不同的单元格，使用-来分隔表头和其他行

|表头|表头|表头|
|—|---|—|
|单元格|单元格|单元格|
|单元格|单元格|单元格|

效果如下:

表头	表头	表头
单元格	单元格	单元格
单元格	单元格	单元格

对齐方式

• +:设置内容和标题栏居右对齐
• :-设置内容和标题栏居左对齐
• :-:设置内容和标题栏居中对齐

左对齐示例	右对齐示例	居中对齐示例
单元格	单元格	单元格
单元格	单元格	单元格

高级技巧

支持的HTML元素

不在Markdown涵盖范围之内的标签，都可以直接在文档里面用HTML撰写
目前支持的HTML元素有：<kbd><b><i><em><sup><sub><br>等

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

效果如下：

使用 Ctrl+Alt+Del重启电脑

<b>粗体文本</b>
粗体文本

<i>斜体文本</i>
斜体文本

<em>强调的文本内容</em>
强调的文本内容

一般文本^上标文本
一般文本^下标文本

一般文本_下标文本
一般文本_下标文本

<br>换行符<br><br>换行符<br>

换行符

换行符

转义

反斜杠（\）转义特殊字符

*斜体*
\*正常显示星号\*

效果如下

斜体
*正常显示星号*

公式

两个美元符$$包裹Tex或者LaTex格式的数学公式来实现
提交后，问答和文章页会根据需要加载Mathjax对数学公式进行渲染

关于空格

&nbsp;不换行空格，全称是 No-Break Space，它是最常见和我们使用最多的空格，大多数的人可能只接触了 ，它是按下space键产生的空格。在HTML中，如果你用空格键产生此空格，空格是不会累加的（只算1个）。要使用html实体表示才可累加，该空格占据宽度受字体影响明显而强烈。

&ensp;它叫“半角空格”，全称是 En Space，en是字体排印学的计量单位，为em宽度的一半。根据定义，它等同于字体度的一半（如16px字体中就是8px）。名义上是小写字母n的宽度。此空格传承空格家族一贯的特性：透明的，此空格有个相当稳健的特性，就是其占据的宽度正好是1/2个中文宽度，而且基本上不受字体影响。

 它叫“全角空格”，全称是 Em Space，em是字体排印学的计量单位，相当于当前指定的点数。例如，1 em在16px的字体中就是16px。此空格也传承空格家族一贯的特性：透明的，此空格也有个相当稳健的特性，就是其占据的宽度正好是1个中文宽度，而且基本上不受字体影响。

---

1. 解释内容 ↩︎