Markdown 语法手册

1、粗体和斜体

代码:

1.*斜体*或_斜体_
2.**粗体**
3.***加粗斜体***
4.~~删除线~~

显示效果:

  • 这是一段斜体
  • 这是一段粗体
  • 这是一段加粗斜体
  • 删除线

2、分级标题

代码:

1.# 一级标题 #
2.## 二级标题 ##
3.### 三级标题 ###
4.#### 四级标题 ####

显示效果:

  • 一级标题

  • 二级标题

  • 三级标题

  • 四级标题

3、超链接

Markdown 支持两种形式的链接语法:行内式和参考式两种形式,行内式一般使用较多

3.1 行内式

语法说明:

  • []里写链接文字
  • ()里写链接地址,()中的“”中可以写为链接指定的title属性,title属性不是必须填写,当鼠标停留在连接上会显示出title文字。

代码:

1.欢迎来到[www.peter-zhou.com](http://www.peter-zhou.com)
2.
3.欢迎来到[周先生的博客](http://www.peter-zhou.com "周先生的博客")

显示效果:

欢迎来到www.peter-zhou.com

欢迎来到周先生的博客

3.2 参考式

语法说明: 参考式链接分为两部分

  • 文中的写法[链接文字][链接标记],在文本的任意位置添加[链接标记]:链接地址 "链接标题",链接地址与链接标题之间相隔一个空格
  • 如果链接文字本身可以作为链接标记,你也可以写成[链接文字][],[链接文字]:链接地址的形式,见代码的最后一行

代码:

1.我经常去的网站,[www.peter-zhou.com][1],[周先生][2],以及[周先生的博客][]是一个不错的网站
2.
3.[1]:http://www.peter-zhou.com "peter-zhou"
4.[2]:http://www.peter-zhou.com "周先生"
5.[周先生的博客]:http://www.peter-zhou.com

显示效果:

我经常去的网站,www.peter-zhou.com,周先生,以及周先生的博客是一个不错的网站

3.3 自动链接

语法说明: Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用<>包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样

代码:

1.<http://www.peter-zhou.com>
2.<address@peter-zhou.com>

显示效果:

http://www.peter-zhou.com address@peter-zhou.com

4、锚点

5、列表

5.1 无序列表

使用 *,+,- 表示无序列表。

代码:

1. - 无序列表 1
2. - 无序列表 2
3. - 无序列表 3

显示效果:

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

5.2有序列表

有序列表使用数字接一个英文句点。

代码:

1.  1. 有序列表 1 
2.  2. 有序列表 2
3.  3. 有序列表 3

显示效果:

  1. 有序列表 1
  2. 有序列表 2
  3. 有序列表 3

5.3 列表嵌套

代码:

1. - 无序列表 1
2.    1. 有序列表 1
3.    2. 有序列表 2
4. - 无序列表 2
5.    - 无序列表 1
6.    - 无序列表 2

显示效果:

  • 无序列表 1
    1. 有序列表 1
    2. 有序列表 2
  • 无序列表 2
    • 无序列表 1
    • 无序列表 2

6、引用

语法说明:引用需要在被引用的文本前加上>符号。

代码:

1. >这是一个有两段文字的引用,
2. >无意义的占行文字1.
3. >无意义的占行文字2.
4. >
5. >无意义的占行文字3.
6. >无意义的占行文字4.

显示效果:

这是一个有两段文字的引用, 无意义的占行文字1. 无意义的占行文字2.

无意义的占行文字3. 无意义的占行文字4.

6.1 引用的多层嵌套

区块引用可以嵌套(例如:引用内的引用),只要根据不同的层次加上不同数量的>

代码:

1.>>> 请问 xxx 怎么样? - 小白
2.>>
3.>> http://xxx  - xx客服
4.>
5.> 感觉不错 - 小白

显示效果:

请问 xxx 怎么样? - 小白

http://xxx - xx客服

感觉不错 - 小白

7、插入图像

图片的创建方式与超链接相似,而且和超链接一样也有两种写法,行内式和参考式写法。

语法中图片Alt的意思是如果图片因为某些原因不能显示,就用定义的图片Alt文字来替代图片。图片的Title则和链接中的Title一样。表示鼠标悬停与图片上时出现的文字。Alt 和Title都不是必须的。

7.1 行内式

语法说明: ![图片Alt](图片地址 "图片title")

代码:

1.xxx:
2.![not found](http://xxx/logo.png "xxx")

显示效果:

xxx: not found

7.2 参考式

语法说明: 在文档要插入图片的地方写 ![图片][标记] 在文档的最后写上[标记]:图片地址 "title"

代码:

1.xxx:
2.![xxx][logo]
3.
4.[logo]:http://xxx/logo.png "xxx"

显示效果:

xxx

8、内容目录

9、表格

语法说明:

  1. 不管是哪一种方式,第一行为表头,第二行分割表头和主体部分,第三行开始为每一行表格行
  2. 列与列之间用管道 | 隔开。原生方式的表格每一行的两边也要有管道
  3. 第二行还可以为不同的列指定对其方向。默认为左对其,在-右边加上:就右对齐。

代码: 简单写法:

1.学号|姓名|分数
2.-|-|-
3.小红|女|90
4.小明|男|88
5.小白|男|91

原生态写法:

1.|学号|姓名|分数|
2.|-|-|-|
3.|小红|女|90|
4.|小明|男|88|
5.|小白|男|91|

指定对其方式:

1.平台|效果
2.-:|-
3.普通直播(yy语音,腾讯课堂等)| 一般
4.1对1上课| 非常好

效果: 简单写法:

学号 姓名 分数
小红 90
小明 88
小白 91

原生态写法:

学号 姓名 分数
小红 90
小明 88
小白 91

指定对其方式:

平台 效果
普通直播(yy语音,腾讯课堂等) 一般
1对1上课 非常好

10、分割线

你可以在一行中用三个以上的 星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。

代码:

1. * * *
2.
3.***
4.
5.*****
6.
7.- - - 
8.
9. -----------------------

效果都一样都是:


11、代码

对于程序员来说这个功能是必不可少的,插入程序代码的方式有两种,一种是利用缩进(Tab),另一种是利用"`"(反引号)包裹代码 语法说明:

  1. 插入行内代码,即插入一个单词或者一句代码的情况,使用code这样的形式插入。
  2. 插入多行代码,可以使用缩进或者"code"

11.1 行内式

代码: 1.C语言里的函数scanf()怎么使用?

显示效果: C语言里的函数scanf()怎么使用?

11.2 缩进式多行代码

缩进4个空格或是1个制表符

代码:

1.  #include <stdio.h>
2.  int main(void)
3.  {
4.        printf("周先生的博客\n");
5.  }

显示效果:

#include <stdio.h>
int main(void)
{
   printf("周先生的博客\n"); 
}

11.3 六个`包裹多行代码

代码:

1.```
2.#include<stdio.h>
3.int main(void)
4.{
5.    printf("周先生的博客");
6.}
7.```  

显示效果:

#include <stdio.h>
int main(void)
{
    printf("周先生的博客");
}

12、复选框

代码:

1.- 未完成事项
2.- [ ] 买车
3.- [ ] 买房
4.- [ ] 娶媳妇
5.
6.- 已完成事项
7.- [x] 都完成,在梦里

显示效果:

  • 未完成事项
  • [ ] 买车
  • [ ] 买房
  • [ ] 娶媳妇
  • 已完成事项
  • [x] 都完成,在梦里

results matching ""

    No results matching ""