markDown语法笔记

Markdown笔记

语法类别

• 区块元素

  1. 标题、段落和换行
  2. 引用（标注性类容）
  3. 列表
  4. 代码区块
  5. 分割线

• 区段元素

  1. 链接
  2. 强调
  3. 代码
  4. 图片

• 其他
  
  
  
  

区块元素

*标题、段落、换行

标题有两种描述方式

1. 使用#号标记，#号数量为 1- 6个，示例如下
   
   # this is Title — 对应h1
   ## this is Title — 对应h2
   …
2. 使用=和—标记
   this is Title
   ===
   this is Title
   ----

段落


        一个 Markdown段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行（空行的定义是显示上看起来像是空的，便会被视为空行。比方说，若某一行只包含空格和制表符，则该行也会被视为空行）。普通段落不该用空格或制表符来缩进。
「由一个或多个连续的文本行组成」这句话其实暗示了 Markdown 允许段落内的强迫换行（插入换行符），这个特性和其他大部分的 text-to-HTML 格式不一样（包括 Movable Type 的「Convert Line Breaks」选项），其它的格式会把每个换行符都转成 br 标签。

换行
HTML 换行符 br

*引用

Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。如果你还熟悉在 email 信件中的引言部分，你就知道怎么在 Markdown 文件中建立一个区块引用，那会看起来像是你自己先断好行，然后在每行的最前面加上 >。


示例


> 这些是引用内容

引用符 + 内容: > + content
markDown下显示为

这些是引用内容

*列表

列表分为有序和无序


a. 无序列表（标识符 + 内容—示例如下）

* + 内容
+ + 内荣
- + 内容 

b. 有序列表(1.+ 空格 + 内容)  ，这种情况下会自动生成1. 、2. 、3. 4.、… ，示例如下：

1. first
2. second
3. thrid
   
   

*代码块

三种方式表示
a.整体内容 + 四个空格

public static void doSomeThing()
{

}

b. ```代码类型 + code + ```

示例 ```java + code + ```

public static void doSomeThing()
{

}

c. ` + content + ` ,标示这是一个代码内容

doSomeThing()

*分割线

两种表示方法


a.*******表示

---

b. -----------表示

---

区段元素

*链接

有行内式和参考式

行内式格式为: [链接名称]（实际的链接地址）

[百度一下](https://www.baidu.com)

百度一下

参考式格式为:[链接名称][链接Tag] + tag对应的实际链接内容
[百度一下][URL_id]

[URL_id]:https://www.baidu.com

百度一下

*强调

markdown中强调的方式有两种:

a.*强调内容*

这种方式中*的数量为不定，但是要求左右两侧*的数量必须相等；

b._强调内容_
与a方式的用法一样，_数量不固定，要求左右两侧的符号数量相等；

*代码

语法格式: `标记内容`，这种方式标记的内容会默认为是代码

示例: public static void doSomeThing(){}

这种方式标记的内容不能换行，一般用于标记一个方法或者很少的内容

* 图片

图片的使用与链接的方式相似，也有参考式和行内式，语法格式如下:

a.行内式：
 ，图片的地址默认使用相对文件路径，参考的是Markdown文件所在的目录，也可以是URL链接。

b.参考式：
![图片描述][AddressTag]

[AddressTag] 与[AddressTag]:具体地址 之间加空行，不是使用br换行符，而是空出一行的空间。

其他

markdown中使用特殊字符时，像java中一样，需要在前面加\转译

锚定位

定位第二步
锚点是是网页制作中超级链接的一种，又叫命名锚记。命名锚记像一个迅速定位器一样是一种页面内的超级链接，运用相当普遍。

创建到命名锚记的链接的过程分为两步。首先，创建命名锚记，然后创建到该命名锚记的链接。

第一步:首先是建立一个跳转的连接。注意符号 # 和 target 参数要设置正确：

<a href="#jump" target="_self">说明文字</a>

跳转位置
第二步：
然后标记要跳转到什么位置即可。文字颜色可随意设置，这里以红色为例：

<span id = "jump"><font color="red">跳转到这里：</font></span>

Tab

| author | create_at | resaon |
| -------| --------| ---------|
| AJ_Ray | 2018/09/09 | markdown |

author	create_at	resaon
AJ_Ray	2018/09/09	markdown