Markdown语法

2018/5/28 22:06:18


有些markdown样式转Html不受支持,所以本篇文章请参考 本篇Markdown源码


注释

Markdown可以添加注释,注释是为了方便自己阅读,不会显示出来
语法如下:

<!-- 注释内容 -->


字体

斜体

使用单个*或_符号包围文字
例如:

斜体格式: *斜体内容*

显示效果:斜体内容

粗体

使用两个*或_符号包围文字

例如:

粗体格式: **粗体内容**

显示效果:粗体内容

斜体并同时加粗

使用三个*或_符号包围文字

例如:

斜体并同时加粗格式: ***斜体并同时加粗***

显示效果:斜体并同时加粗

删除线

使用两个\~符号包围文字

例如:

粗体格式: \~\~删除线内容\~\~

显示效果:~~删除线内容~~

上标

使用一个\^符号
例如:

上标格式: 上\^标,或者上\^标\^标

显示效果:上^标 ,或者上^标^标

如果上标中间本来就带有空格,就将内容用括号括起来

例如:

上标格式: 上\^标 上标

显示效果:上^(标 上标)


标题

Markdown支持6个等级的标题,例如:

# 标题 1

## 标题 2

### 标题 3

#### 标题 4

##### 标题 5

###### 标题 6

在文字前面加#符号,也可以在文字结尾处也加#来闭合 显示效果如下:

标题 1

标题 2

标题 3

标题 4

标题 5
标题 6

还有一种方式,只能表示2个等级的标题,即在文字下放输入若干个-(一级标题)、\=(二级标题)。


列表

Markdown支持两种形式的列表:有序列表和无序列表

无序列表

在每个列表项之前用+、-或*符号,而且符号和内容要用空格分开。格式如下:

* 项目 1

+ 项目 2

- 项目 3

显示效果:

  • 项目 1
  • 项目 2
  • 项目 3
有序列表

在每个列表项之前用一个阿拉伯数字,并且数字后面要有个“.“和一个空格。数字不限大小,也没有顺序限制。显示效果是以1为第一项依次递增的,格式如下:

5. 项目 1

8. 项目 2

2. 项目 3

显示效果:

  1. 项目 1
  2. 项目 2
  3. 项目 3
多级列表

可以使用有序列表或无序列表,也可以混合使用。用空格分级,第二级前有一个空格,第三级前有两个空格,依次类推。格式如下:

  1. 项目 1

    • 项目 2
    • 项目2的子无序列表 1
    • 项目2的子无序列表 2
    • 项目2的子无序列表 3
  2. 项目 3

列表分行

一个列表项也可以分行显示,只用在除第一行外接下来的行加上四个空格即可。格式如下:

* 多行列表项目1

(四个空格)这是第二行

* 项目2

显示效果:

  • 多行列表项目1 这是第二行
  • 项目2

代码

Markdown可以使用内联代码,也可以使用代码块。

内联代码:

内联代码是夹杂在一段话中的,使用`符号包围代码即可。`符号是键盘上ESC下方,数字键1(不是小键盘)的左边那个,半角状态下输入

这是一些 ``内联代码 **嵌套格式**``

显示效果:

这是一些 内联代码 **嵌套格式**

代码块

简单方式是在每行代码前使用至少4个空格,如下:

public void main(Strings argv[]){
    System.out.println("Hello world!");
}

也可以使用三个`符号来包围代码块,并可以指定编程语言:

```csharp

public static void Main(string[] args) { Console.WriteLine("Hello world!"); }

```

显示效果:

csharp public static void Main(string[] args) { Console.WriteLine("Hello world!"); }


链接

有两种方式来表示链接

直接输入链接

http://vivek.wang

显示效果:

http://vivek.wang

 

特定格式

这种方式可以选择该链接的显示内容:

[vivek.wang](http://vivek.wang)

显示效果:

vivek.wang

 

文字提示:

[vivek.wang](http://vivek.wang ”vivek“)

显示效果:

vivek.wang.

 

相对链接

Markdown也支持相对链接

[Relative Link](/Assets/Photos/Photos.json)

显示效果:

Relative Link

 

或者

[Relative Link 2](../Photos/Photos.json)

显示效果:

Relative Link 2


邮箱链接

邮件地址也可以作为链接显示

[vivek.wang](vivek.wang@outlook.com)

会链接至 vivek.wang

也可以直接输入邮件地址

vivek.wang@outlook.com

会链接至 vivek.wang@outlook.com


图片

你可以添加像链接一样添加图片,只用在地址前添加!符号

![百度一下,你就知道](https://www.baidu.com/img/bd_logo1.png)

显示效果:

百度一下,你就知道  

区块引用

可以使用>符号来表示引用,而且可以嵌套使用:

>引用1
>引用2
>>引用2.1
>>引用2.2
>引用3
>>引用3.1
>>引用3.2
>>>引用3.2.1
>>>引用3.2.2
>>引用5.4
>引用6

显示效果:

引用1

引用2

引用2.1

引用2.2

引用3

引用3.1

引用3.2

引用3.2.1

引用3.2.2

引用5.4

引用6


Emoji表情

你可以使用几乎所有Emoji表情。只用使用:符号包围表情名称,格式如下:

:apple: :smile:

显示效果:

🍎 😄

你可以使用几乎所有emoji表情,名称及对应表情请参考这里


表格

Markdown表示表格有点麻烦,但相比Word排版还是简单很多。格式如下:

这是|头部|标签
:---|:--:|---:
左对齐|居中|居右
1|2|3
a|b|c

显示效果:

这是|头部|标签 :---|:--:|---: 左对齐|居中|居右 1|2|3 a|b|c

输入特殊符号

你可能需要输入\、`等符号,但是如果直接输入,会被Markdown当初特殊符号来处理。只用在特殊符号前多输入个\(转义字符)即可。格式如下:

特殊符号 \*斜体\*

显示效果:

特殊符号 *斜体*

水平线

只要连续输入5个*符号即可创建一个水平线。如下:

*****

显示效果:


初心日记的Markdown经过定制,Markdown的特殊颜色也跟随主题色


有些markdown样式转Html不受支持,所以本篇文章请参考 本篇Markdown源码