markDown基础语法

---

title: markDown基础知识
date: 2018-06-14 18:30:48
categories:
-前端
-教程
tags:

-Markdown

markDown简介

是以普通文本编辑器编写的一种标记语言。通过简单的标记语法，是文本具有一定的标记格式

markDown基础知识

区块元素

段落和换行

一个段落：由一个或多个连续的文本行组成。它的前后要有一个以上的空行。
换行：简单地「每个换行都转换为 <br />的方法在 Markdown 中并不适合，MarkDown需在插入处先按上两个以上的空格，然后回车转换为 <br />。

标题

两种标题语法：类 Setext 和类 atx 形式

a、类 Setext 形式:是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题)
b、类 atx 形式:在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶，你可以选择性地「闭合」类 atx 样式的标题，这纯粹只是美观用的，若是觉得这样看起来比较舒适，你就可以在行尾加上 #

区块引用

a、是使用类似 email 中用 > 的引用方式，在每行、每个段落的每一行的最前面 加上>，允许你偷懒只在整个段落的第一行最前面加上 >
b、区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 >，>与>之间有一个空格
c、引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等

列表

列表分为有序列表和无序列表两种

a、无序列表：使用“*、+、-”作为列表标记
b、有序列表：使用数字加英文状态下‘.’，列表上标记的数字并不会影响html结果的输出
c、列表项目标记通常是放在最左边，可以缩进，最多3个空格，项目标记后面则一定要接着至少一个空格或制表符。如果列表项目间用空行分开，在输出 HTML 时 Markdown 就会将项目内容用 <p>标签包起来

代码块

a、推荐使用““`”加代码类型

\`\`\`javascript
    Console.log(1)
\`\`\`

b、如果要标记一小段行内代码，你可以用反引号把它包起来（`）
Use the `printf()` function
c、如果要在代码区段内插入反引号，你可以用多个反引号来开启和结束代码区段
d、用TAB键起始或起始时空4个空格的段落，会被认为是代码块

分割线

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

区段元素

链接：

支持两种链接行式：行内式和参考式，链接文字都是用 [方括号] 来标记。

a、建立一个行内式的链接，只要在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，例如：

This is [an example](http://example.com/ "Title") inline link.
会产生：
<p>This is <a href="http://example.com/" title="Title"> an example</a> inline link.</p>
b、参考式的链接是在链接文字的括号后面再接上另一个方括号，而在第二个方括号里面要填入用以辨识链接的标记
This is [an example][id] reference-style link.
接着，在文件的任意处，你可以把这个标记的链接内容定义出来：
[id]: http://example.com/ "Optional Title Here"

链接内容定义的形式为：
• 方括号（前面可以选择性地加上至多三个空格来缩进），里面输入链接文字
• 接着一个冒号
• 接着一个以上的空格或制表符
• 接着链接的网址
• 选择性地接着 title 内容，可以用单引号、双引号或是括弧包着， Markdown.pl 1.0.1 会忽略单引号包起来的链接 title

c、隐式链接标记功能让你可以省略指定链接标记，这种情形下，链接标记会视为等同于链接文字，要用隐式链接标记只要在链接文字后面加上一个空的方括号，如果你要让 “Google” 链接到 google.com，你可以简化成：[Google][]

自动链接

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

锚点

网页中，锚点其实就是页内超链接，也就是链接本文档内部的某些元素，实现当前页面中的跳转。
创建到命名锚记的链接的过程分为两步首先，创建命名锚记，然后创建到该命名锚记的链接。
语法描述
在你准备跳转到的指定标题后插入锚点{ # 标记 }，然后在文档的其它地方写上连接到锚点的链接

强调

Markdown使用星号（*）和底线（_）作为强调字词的符号。
1. 被 一个* 或 _ 包围的字词会被转成用 <em>标签包围
2. 用两个 * 或 _ 包起来的话，则会被转成 <strong>
3. 用三个 * 或_ 包起来的话，则会被转成 <strong><em>综合效果。
4. 两个~~表示删除线
注意：你用什么符号开启标签，就要用什么符号结束。但是如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号。
如果要在文字前后直接插入普通的星号或底线，你可以用反斜线：
\*this text is surrounded by literal asterisks\*

图片

Markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式： 行内式和参考式
a：行内式

a、! [Alt text](/path/to/img.jpg “Optional title”)
b、参考式! [Alt text][id]
到目前为止， Markdown 还没有办法指定图片的宽高，如果你需要的话，你可以使用普通的 <img> 标签。

表格

1.使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行，默认居中对齐
2.在表头下方的分隔线标记中加入 :，即可标记下方单元格内容的对齐方式：
:— 代表左对齐
:–: 代表居中对齐
—: 代表右对齐
如果不使用对齐标记，单元格中的内容默认左对齐；表头单元格中的内容会一直居中对齐(不同的实现可能会有不同表现)

代码示例

左对齐       |  居中       |右对齐  
:-----------| ：--------:| --------:|  
Left Cell  | Content Cell |right cell  
left Cell  | Content Cell | right cell  

效果：

左对齐	居中	右对齐
Left Cell	Content Cell	right cell
left Cell	Content Cell	right cell

其他

1：反斜杠：Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果（但不用 <em>标签），你可以在星号的前面加上反斜杠：
*literal asterisks*
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

\  反斜线 
*  星号 
`  反引号 
_  底线 
{} 花括号 
[] 方括号 
() 括弧 
\#  井字号 
+  加号 
-  减号 
.  英文句点 
!  惊叹号