MarkDown基本语法

本文介绍MarkDown的基本语法。

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。

Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。

Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。

Markdown 编写的文档后缀为 .md, .markdown。

标题


示例:

代码语言:javascript
复制
# 一级标题

二级标题

三级标题

四级标题

五级标题

效果:

一级标题

二级标题

三级标题

四级标题
五级标题

引用


示例:

代码语言:javascript
复制
> 一级引用

>> 二级引用

> 嵌套引用
>
>>>test

效果:

一级引用

二级引用

嵌套引用
test

字体与分割线


示例:

代码语言:javascript
复制
粗体 或者 粗体

斜体 或者 斜体

斜体加粗 或者 斜体加粗

<kbd>键盘体</kbd> (html标签)

加框文字

行内代码

删除线

<ins>下划线</ins> (html标签)

分割线:使用三个或者三个以上的(-)或者(*)
例如: --- 或者 ***

效果:

粗体

斜体

斜体加粗

键盘体

这是一段 加框 的文字

Hello,我是一段 行内代码 ,你懂了吗?

删除线

下划线

分割线:


列表


示例:

代码语言:javascript
复制
无序列表用 - + * 任何一种都可以
例如:

  • 列表内容A
  • 列表内容B
  • 列表内容C

有序列表用 数字+· 的形式
例如:

  1. 列表内容1
  2. 列表内容2
  3. 列表内容3

列表嵌套只要在上一级和下一级之间敲三个空格即可
(同类型和不同类型的列表都可以嵌套)
例如:

  • 一级列表
    (这里敲了三个空格)
  1. 二级列表1
  2. 二级列表2
  3. 二级列表3

效果:

无序列表:

  • 列表内容A
  • 列表内容B
  • 列表内容C
  • 有序列表:*
  1. 列表内容1
  2. 列表内容2
  3. 列表内容3

插入媒体与超链接


示例:

代码语言:javascript
复制
插入图片:
![图片alt](图片Url '图片title')

插入视频等其他媒体:
可以直接使用HTML的标签,也可以在现在主流媒体网站的分享选项中,找到插入的代码。CtrlC即可!

超链接:
[超链接名](超链接Url "超链接title")

邮箱地址:
<邮箱地址>

注意:以上title都可以不写,这是鼠标移上去显示的名称。
Markdown语法不支持链接在新的标签页中打开,不过有些网站做了特殊处理,是可以的。有的平台可能就不行了,如果想要在新页面中打开的话可以用html语言的a标签代替。

效果:

图片Alt

其他媒体演示省略。

超链接名

1005760694@qq.com

表格


示例:

代码语言:javascript
复制
语法:

表头A 表头B 表头C
内容居左 内容居中 内容居右
内容居左 内容居中 内容居右

第二行分割表头和内容。

  • 有一个就行,为了对齐,有时候可以多加几个,不过有可能有些编辑器会出问题。
    文字默认居左
    -两边加:表示文字居中
    -右边加:表示文字居右
    注:原生的语法两边都要用 | 包起来。也可以省略。

效果:

表头A

表头B

表头C

内容居左

内容居中

内容居右

内容居左

内容居中

内容居右

插入代码块


示例:

代码语言:javascript
复制
{```}[language] [title] [url] [link text]

(常见的支持:HTML、C、C#、CSS、Delphi、Java、JavaScript、JSON、Php、Python、Shell、SQL、XML、Matlab、GO等等还有很多)

#include<stdio.h>
void main(){
while(1){
printf("hello world!\n");
}
}

{```}
使用时去掉大括号

效果:

代码语言:javascript
复制
#include<stdio.h>
void main(){
while(1){
printf("hello world!\n");
}
}

其他补充


MarkDown还有脚注([^要注明的文本]),使用反斜杠、感叹号、花括号进行转义等等,这些之外,他还全面支持HTML标签,有些时候也可以使用HTML标签来编写文档。

总而言之,MarkDown不仅是简单易学,还十分强大。