blog icon indicating copy to clipboard operation
blog copied to clipboard

Markdown 语法

Open qingquan-li opened this issue 8 years ago • 0 comments

事实上,在 Markdown 原生语法的基础上,还有一些衍生的语法,例如之前我在另一篇博客 Markdown 是什么 中介绍的 Ulysses 编辑器的 Markdown 语法、 GitHub 风格的 Markdown 语法,不用担心,他们也大同小异。下面介绍的是常用的 Markdown 语法及其显示效果,几分钟你就可以掌握这世界上流行的文本标记语言。 这里主要介绍 GitHub 风格的 Markdown 语法。

Markdown線上編輯器 MdEditor : https://www.mdeditor.tw/


一、标题

行首插入 1~6 个 # ,标题字体由大到小。等同 HTML 的 h1~h6 。(注意:以后添加语法符号之后都需要添加一个空格

# Header 1
## Header 2
### Header 3
#### Header 4
##### Header 5
###### Header 6

显示效果如下:

Header 1

Header 2

Header 3

Header 4

Header 5
Header 6




二、文本样式

(实际上,带“*”星号的文本样式,在原版Markdown标准语法中不存在,但在其大部分衍生标准中被添加)

链接: [](URL) 实例:[FatliTalk](https://github.com/FatliTalk/blog)
显示效果:FatliTalk



加粗: 2对星号 实例:**Bold** 显示效果: Bold



斜体字: 1对下划线 实例: _Italics_
显示效果: Italics



删除线: 2对波浪号 实例: ~~Strikethrough~~ 显示效果: ~~Strikethrough~~



无序列表: 1对短横杆 实例: - 无序列表1
- 无序列表2
- 无序列表3

显示效果:

  • 无序列表1
  • 无序列表2
  • 无序列表3


有序列表: 阿拉伯数字+点+空格 实例: 1.有序列表1
2.有序列表2
3.有序列表3

显示效果:

  1. 有序列表1
  2. 有序列表2
  3. 有序列表3


引用: 1个大于号
实例: > FatliTalk by Fatli。
> FatliTalk——讨论关于技术,关于世界。

显示效果:

FatliTalk by Fatli。
FatliTalk——讨论关于技术,关于世界。



水平分隔线: 3个短横杠 实例:---

显示效果:





三、插入图片:

语法: ![](URL)

语法比添加链接多了一个感叹号

![Fatli的GitHub头像](https://avatars3.githubusercontent.com/u/19491358?v=3&s=460)

显示效果:

Fatli的GitHub头像



四、插入代码:

内嵌代码,使用一个回勾号: “ ` ” (在键盘 1 键左边):

`alert('Hello World');`
显示效果: alert('Hello World');



插入代码块(介绍2种格式的插入代码块方式:标准Markdown语法、GitHub风格的Markdown语法)

标准 Markdown语法,使用缩进4个空格的方式(4点代表4空格): ····<header>
········<h1>{{title}}</h1>
····<header>

显示效果:

<header>
	<h1>{{title}}</h1>
</header>  


GitHub风格的Markdown语法,使用三个回勾号(“```”):

``` <header>
    <h1>{{title}}</h1>
<header>
```

显示效果同上



附: GitHub 风格的 Markdown 语法,可以插入指定语言的代码块:

```javascript alert("Hello, Markdown!"); ```

显示效果:

alert("Hello, Markdown!");



五、转义字符:

语法:在 Markdown 语法符号前,添加反斜杠 “ \ ” 。
如果我们需要输出的就是 Markdown 语法符号,就需要用到转义字符,例如:

\> FatliTalk by Fatli. \> FatliTalk——讨论关于技术,关于世界。

显示效果:

> FatliTalk by Fatli. > FatliTalk——讨论关于技术,关于世界。




六、表格

语法:使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行

| name | age | | ---------|---- | | Fatli_Lee | 18 | | Xenia | 18 |

显示效果:

name age
Fatli_Lee 18
Xenia 18



七、任务列表

- [x] 任务一 - [ ] 任务二 - [ ] 任务三

显示效果:

  • [ ] 任务一
  • [ ] 任务二
  • [x] 任务三



更多参考:

qingquan-li avatar Jan 06 '17 16:01 qingquan-li