Markdown Syntax

Posted on   |   In   |  

Markdown的常用语法

简介

Markdown 是一种轻量级标记语言，它用简洁的语法代替排版，使我们专心于码字。它的目标是实现易读易写，成为一种适用于网络的书写语言。同时，Markdown支持嵌入html标签。
注意：Markdown使用#、+、*、>等符号来标记， 符号后面必须跟上 至少1个 空格才有效！

标题

Markdown 标题支持两种形式：

  • 用'#'标记
    在标题开头 加上1~6个#，依次代表一级标题、二级标题….六级标题
    1
    2
    3
    4
    5
    # 一级标题
    ## 二级标题
    ### 三级标题
    ##### 四级标题
    ###### 五级标题

效果如下：

一级标题

二级标题

三级标题

四级标题
五级标题
  • 用'='和'-'标记
    在标题底下加上任意个=代表一级标题，-代表二级标题（’-‘个数应小于3个） 
    1
    2
    3
    4
    一级标题
    ========
    二级标题
    --------

效果如上：

列表

Markdown 支持有序列表和无序列表

  • 无序列表使用-、+和*作为列表标记： 
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    - Red  
    - Green  
    - Blue  
    -------   
    * Red   
    * Green  
    * Blue
    -------  
    + Red  
    + Green  
    + Blue

效果均如下：

  • Red
  • Green
  • Blue
  • 有序列表则使用数字加英文句点.来表示： 
    1
    2
    3
    1. Red  
    2. Green    
    3. Blue

效果如下:

  1. Red
  2. Green
  3. Blue

引用

引用以>来表示，引用中支持多级引用、标题、列表、代码块、分割线等常规语法.
常见的引用写法：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
> 这是一段引用    //在`>`后面有 1 个空格
> 
>     这是引用的代码块形式    //在`>`后面有 5 个空格
>     
> 代码例子：
>   
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
> 一级引用
>> 二级引用
>>> 三级引用
> #### 这是一个四级标题
> 
> 1. 这是第一行列表项
> 2. 这是第二行列表项

效果如下：
这是一段引用

这是引用的代码块形式    //在`>`后面有 5 个空格

代码例子：

protected void onCreate(Bundle savedInstanceState) {  
    super.onCreate(savedInstanceState);  
    setContentView(R.layout.activity_main);

}
一级引用

二级引用

三级引用

  1. 这是第一行列表项
  2. 这是第二行列表项

强调

  • 两个*或-代表加粗，一个*或-代表斜体，~~代表删除。 
    1
    2
    3
    **加粗文本** 或者 __加粗文本__  
    *斜体文本*  或者_斜体文本_  
    ~~删除文本~~

效果如下：
加粗文本 或者 加粗文本
斜体文本 或者_斜体文本_
删除文本

图片与链接

  • 图片与链接的语法很像，区别在一个 ! 号。二者格式：

    1
    2
    图片：![]()    ![图片文本(可忽略)](图片地址)  
    链接：[]()     [链接文本](链接地址)

  • 链接又分为行内式、参考式和 自动链接：

    1
    2
    3
    4
    5
    6
    7
    这是行内链接：[Hugo's Blog](http://www.cycygogo.cn/)  
    这是参考式链接：[Hugo's Blog][url]，其中'url'可为任意名字，只需和下面的链接名称相对应，  
    [url]: http://www.cycygogo.cn/ "Hugo's Blog"（可位于文中任意位置）  
    链接标记格式为：[链接标记文本]:  链接地址  链接title(可忽略)
    这是自动链接：直接使用`<>`括起来<http://www.cycygogo.cn>
    这是图片：![][Python]  
    [Python]: /home/ubuntu/Deep Learning/Py_Science.png

效果如下:
这是行内链接：Hugo’s Blog
这是参考式链接：Hugo’s Blog
这是自动链接：直接使用<>括起来http://www.cycygogo.cn
这是图片：

代码

代码分为行内代码和代码块

  • 行内代码使用 `代码` 标识，可嵌入文字中
    这是行内代码onCreate(Bundle savedInstanceState)的例子。

  • 代码块使用4个空格或```标识 

    1
    这里是代码

  • 代码语法高亮在 ```后面加上空格和语言名称即可

    1
    2
    3
    4
    // 注意python前面有空格
    import sys
    def func1(a, b):
        return a+b

表格

表格对其格式

  • 居左::----
  • 居中::----:或-----
  • 居右:----:
    例子：
    1
    2
    3
    4
    5
    6
    |标题|标题|标题|
    |:---|:---:|---:|
    |居左测试文本|居中测试文本|居右测试文本|
    |居左测试文本1|居中测试文本2|居右测试文本3|
    |居左测试文本11|居中测试文本22|居右测试文本33|
    |居左测试文本111|居中测试文本222|居右测试文本333|
标题 标题 标题
居左测试文本 居中测试文本 居右测试文本
居左测试文本1 居中测试文本2 居右测试文本3
居左测试文本11 居中测试文本22 居右测试文本33
居左测试文本111 居中测试文本222 居右测试文本333

分割线

在一行中用三个以上的*、-、_来建立一个分隔线，行内不能有其他东西。也可以在符号间插入空格。

1
2
3
***
___
___

效果均为分割线

换行

在行尾添加两个空格加回车表示换行：
在行尾添加两个空格 表示换行：
效果如下：
在行尾添加两个空格
表示换行

注脚

使用来定义脚注：

1
2
这是一个脚注的例子[^1]  
[^1]: 这里是脚注

这是一个脚注的例子1

1. 这里是脚注 ↩

添加Read More

在博文中合适的位置添加代码<!--more-->

常用弥补Markdown的Html标签

字体

<font face="consolas" color="red" size="6">字体及字体颜色和大小</font>
<font color="#0000ff">字体颜色</font>

效果如下：

字体及字体颜色和大小 字体颜色

换行

1
使用html标签`<br/>`<br/>换行

效果如下：
使用html标签<br/>
换行

文本对齐方式

1
2
3
<p align="left">居左文本</p>
<p align="center">居中文本</p>
<p align="right">居右文本</p>

效果如下：

居左文本

居中文本

居右文本

下划线

<u>下划线文本</u>
效果如下：
下划线文本

文本中输入空格

&ensp;或&#8194;:半方大的空白
&emsp;或&#8195;:全方大的空白
&nbsp;或&#160;:不断行的空白格