markdown必知必会之基础篇

前言

Markdown是一种轻量级的「标记语言」，通常为程序员群体所用，目前它已是全球最大的技术分享网站 GitHub 和技术问答网站 StackOverFlow 的御用书写格式，它具备了以下几点功能：

1. 专注于文字内容
2. 纯文本，易读易写，可以方便地纳入版本控制
3. 语法简单，没有什么学习成本，松在码字的同时做出美观大方的排版

我个人理解，markdown可以认为是通过某些约定俗成的文字格式来编排你的文本，这些文字格式的使用可以通过某些简单的字符来调用，比如两个*扩起文字代表斜体等。通过这样简单的模式，我们可以不再在文字排版上浪费太多的精力，而把注意力转移到文字内容上。本专题主要是系统学习一下它的基础语法和进阶语法，最后再分享几个markdown的编辑工具

一、工作原理

首先markdown被称为语言的原因之一，可能就是它在文本中加入了自己独特的符号来作某种形式的展示，这些符号是需要特定的程序（markdown app或者解释器）来识别后才能被进一步渲染，这就像我们平时使用的R或者python，我们在敲完代码如plot(1)进行作图时，实际上计算机并不知道我们写的东西有什么意义，这些纯文本需要借助R的解释器（我们下载的R软件）将其翻译成计算机能听懂的语言后再使计算机完成我们的操作。markdown也是如此，因此它在运行逻辑上遵循下面的过程：

1. 使用文本编辑器或Markdown专用的应用程序创建Markdown文件。该文件应带有.md或.markdown扩展名。
2. 在Markdown应用程序中打开Markdown文件。
3. 使用Markdown应用程序将Markdown文件转换为HTML文档。
4. 在web浏览器中查看 HTML 文件，或使用Markdown应用程序将其转换为其他文件格式，例如PDF。

另外一点需要提到的是格式问题，markdown最后呈现的排版样式需要用到CSS，这个是html中用于展示元素显示形式的文件（其实也是一门语言）。比如本文在编写的时候,原始文档使用了markdown的语法，在后期选择了一些特化文字格式的CSS后，就变成了比较正式的样子，这个操作类似于，写完文章后使用word中的样式设置，将主标题、副标题、段落这些分别设置不同的格式，之后就可以实现统一修改。

二、markdown的8个简单语法

基础语法包括：

1. 标题语法
2. 强调语法
3. 引用语法
4. 列表语法
5. 代码块语法
6. 链接语法
7. 转义语法
8. 其它语法

这里推荐一个在线markdown编辑器用于练习:在线编辑器。把下面的示例放在这个编辑器里面即可渲染。

1.标题语法

总结为使用n个#代表n级标题，最多到6级。需要注意#与文本之间使用空格分隔。另外一种表示标题的语法是，在标题文本下使用若干=或-，不常用。

# Heading level 1
## Heading level 2
### Heading level 3
#### Heading level 4
##### Heading level 5
###### Heading level 6

Heading level 1
===============

Heading level 2
---------------

2.强调语法

总结为使用*将文本括住来完成加粗和倾斜文本起强调作用。一个*为倾斜，两个*为加粗，三个*为倾斜加粗

*倾斜文本*
**加粗文本**
***倾斜加粗文本***

3.引用语法

总结：在行首使用>对某些文本使用引用框，起强调作用。分为：

1. 普通引用

> 这是一个引用

2. 多个段落块引用

> 我是第一段
>
> 我是第二段

3. 嵌套块引用（引用框中嵌套引用框）

> 我是一段引用
>> 我是引用的引用
>>> 我是引用的引用的引用（禁止套娃）

4. 在引用块中可以使用markdown的其它语法如加粗倾斜。不做赘述。

4.列表语法

1. 行首使用数字.如1.的形式来表示有序列表。

1. First item
2. Second item
3. Third item
4. Fourth item

2. 使用-或*或+表示无序列表（注意，这三种可以任选，但不能混用！）。下面示例只展示一种

- First item
- Second item
- Third item
- Fourth item

3. 使用tab补位后与上述两种情况结合实现复合列表

#有序列表嵌套
1. First item
2. Second item
3. Third item
    1. Indented item
    2. Indented item
4. Fourth item
#无序列表嵌套
- First item
- Second item
- Third item
    - Indented item
    - Indented item
- Fourth item
#有序中嵌套无序
1. First item
2. Second item
3. Third item
    - Indented item
    - Indented item
4. Fourth item

4. 在列表中可以加入其它元素，如文本加粗倾斜等

5.代码块语法

总结：使用`(英文模式下键盘tab键正上方)来将代码进行格式化显示，包括：

1. 单词、代码使用单个`

我旁边有个`code`

2、双`将包含单`的代码行包裹

#如果`中间没有间隔，使用空格进行间隔
我旁边有个 ``我旁边有个`code` ``

3. 三个及以上`表示一个代码块

#这里的\表示转义，防止示例被markdown工具识别，现实使用的时候不用加！
\```
我是代码
我也是代码
我还是代码
\```

6.链接语法

总结:使用形如[标题](链接)的形式展示链接。这一部分稍微复杂一些，分成以下部分

1. 基础链接

#普通
我是一个链接[百度官网](https://www.baidu.com/)
#加个title
我是一个链接[百度官网](https://www.baidu.com/ "大噶好，俺是百度")
#直接展示链接、邮箱地址
请点击旁边的链接进入百度 <https://www.baidu.com/>
这是我的邮箱<fake@example.com>欢迎添加（其实不是）

2. 格式化链接：在链接中使用前面讲的其它语法

#强调语法
I love supporting the **[EFF](https://eff.org)**.
This is the *[Markdown Guide](https://www.markdownguide.org)*.
#代码块
See the section on [`code`](#code).

3. 引用类型链接
   这一类比较复杂，由两部分组成，

• 包含链接名称的部分，表示为[url_name][index]
• 包含链接内容的部分，表示为[index]: url。注意冒号后至少有一个空格

举个例子

[我是一个链接,这是我的名字][1]  
[我是另一个链接，这是我的名字][2]

[1]: https://www.baidu.com/    
[2]: https://www.jianshu.com/

它使URL在Markdown中更易于显示和阅读。参考样式链接分为两部分：与文本保持内联的部分以及存储在文件中其他位置的部分，以使文本易于阅读。简单来说，就是第一部分放在文章中，第二部分可以放到一个专门储存链接的地方，这样你在修改链接的时候，只需要把第二部分修改好就行！

4. 图片链接（在markdown中放图）
   总结为![]()格式来插入图片。因为它跟链接的表示方式很像，就放到一起了。

#普通用法
![这是图片](/assets/img/philly-magic-garden.jpg "Magic Gardens")
#比较高级的用法，链接语法和图片语法套用，点击图片进入链接！
[![沙漠中的岩石图片](/assets/img/shiprock.jpg "Shiprock")](https://markdown.com.cn)

7.转义语法

以下列出的字符都可以通过使用反斜杠字符从而达到转义目的。其它转义信息查询

Character	Name
\	backslash
`	backtick
*	asterisk
_	underscore
{}	curly braces
[]	brackets
()	parentheses
#	pound sign
+	plus sign
-	minus sign (hyphen)
.	dot
!	exclamation mark
	pipe

8.其它语法

• 段落语法
  要创建段落，请使用空白行将一行或多行文本进行分隔。

I really like using Markdown.

I think I'll use it to format all of my documents from now on.

• 换行语法
  在一行的末尾添加两个或多个空格，然后按回车键,即可创建一个换行

This is the first line.  
And this is the second line.

• 分割线语法
  要创建分隔线，请在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ，并且不能包含其他内容。

***

---

_________________