markdown语法解析之基础篇

289 阅读4分钟

Markdown简介:

Markdown是一种轻量级且易于使用的语法,用于设计GitHub平台上所有形式的书写

相较于传统编辑器

优点:编辑效果明显,可以让作者摆脱排版的困扰,有限的精力聚焦在丰富的内容上。
缺点:需要基本语法支持,且并不适用在所有的平台。 以下分6种常用类型介绍基本语法

  • Text-文本类型
  • Lists-列表类型
  • Images-图片类型
  • Headers&Quotes-标题&引用类型
  • Code-代码类型
  • Extras-其他

文本类型

  • 文字加粗
    需要加粗的文字左右两边用两个*号括起来
  • 文字倾斜(斜体)
    需要倾斜的文字左右两边用一个*号括起来
  • 文字加粗倾斜
    需要加粗倾斜的文字左右两边用三个*号括起来
  • 文字加删除线
    需要加删除线的文字左右两边用两个~~号括起来
    演示代码:
**加粗的文字**     
**倾斜的文字**   
**加粗倾斜的文字**   
**加删除线的文字** 

演示效果:
加粗的文字
倾斜的文字
加粗倾斜的文字
加删除线的文字

列表类型

无序列表

语法:-+*任何一种都可以;注意:-+*和内容之间必须要有一个英文空格
演示代码:

- 列表内容
+ 列表内容
* 列表内容

演示效果:

  • 列表内容
  • 列表内容
  • 列表内容

有序列表

语法:数字+点+空格---都是英文状态下的
演示代码:

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

演示效果:

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

列表嵌套

语法:语法同上,嵌套内容的空格必须是英文状态下的 演示代码:

* 一级列表内容
  1. 一级嵌套内容1
  2. 一级嵌套内容2
* 二级列表内容
  1. 二级嵌套内容1
  2. 二级嵌套内容2

演示效果:

  • 一级列表内容
    1. 一级嵌套内容1
    2. 一级嵌套内容2
  • 二级列表内容
    1. 二级嵌套内容1
    2. 二级嵌套内容2

图片类型

语法:![Alt Text](url "title")
演示代码:
![Image of Yaktocat](//p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/161cf16d9c2645438da585c483eba335~tplv-k3u1fbpfcp-zoom-1.image "图片title展示")
演示效果:
Image of Yaktocat

标题&引用类型

标题

语法:#+空格+标题内容
一个#号是一级标题;二个#号是二级标题;一次类推
演示代码:

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

演示效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

引用

语法:>+需要引用的文字
嵌套引用:嵌套几级加几个> 演示代码:

>引用内容
>>二级嵌套引用
>>>三级嵌套应用

演示效果:

引用内容

二级嵌套引用

三级嵌套应用

代码类型

单行代码

语法:`+代码+`
演示代码:`hello world`
演示效果:hello world

代码块

语法:  
```
代码...  
代码...  
``` 

演示代码:

function fn(){
    console.log("to do ...")
}
fn()

演示效果:

function fn(){
    console.log("to do ...")
}
fn()

其他

分割线

语法:三个或者三个以上的-或者*都可以
演示代码:

---
----
***
****

演示效果:





超链接

语法:[超链接名](超链接地址 "超链接title")
演示代码:[GitHub](http://github.com "跳转至github")
演示效果:GitHub
注意:Markdown自身语法暂不支持在新页面中打开链接地址,如果有需要在新页面中打开可以用HTML语言的a标签代替。
演示代码:<a href="超链接地址" target="_blank">超链接名</a>
演示效果:

<a href="超链接地址" target="_blank">超链接名</a>

表格

语法:

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容
第二行用来分割表头和内容;
- 一个就行,多写几个只是为了对齐列表;
文字默认居左对齐;
-两边加冒号:表示文字居中对齐
-左边加冒号:表示居左对齐

演示代码:

姓名|年龄|性别
--|:--:|--:
李明|12|男
王梅|12|女

演示效果:

姓名年龄性别
李明12
王梅12

以上部分内容参考Mastering Markdown