易读易写简洁至上Makedown标记语言

Posted 2020-07-06 逍遥超儿

# 轻量的Markdown 标记语言学习笔记

####导语： 

> [Markdown]{http://zh.wikipedia.org/wiki/markdown}是一种轻量级的「标记语言」，它的优点很多，目前也被越来越多的写作爱好者，撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑，Markdown 的语法十分简单。常用的标记符号也不超过十个，这种相对于更为复杂的 html 标记语言来说，Markdown 可谓是十分轻量的，学习成本也不需要太多，且一旦熟悉这种语法规则，会有一劳永逸的效果。

### 原文链接：http://www.jianshu.com/p/1e402922ee32/     文／Te_Lee（简书作者）

## 一，认识 Markdown
   在刚才的导语里提到，Markdown 是一种用来写作的轻量级「标记语言」，它用简洁的语法代替排版，而不像一般我们用的字处理软件*Word*或 *Pages* 有大量的排版、字体设置。它使我们专心于码字，用「标记」语法，来代替常见的排版格式。例如此文从内容到格式，甚至插图，键盘就可以通通搞定了。目前来看，支持 Markdown 语法的编辑器有很多，包括很多网站（例如[简书](http:jianshu.io)）也支持了 Markdown 的文字录入。Markdown 从写作到完成，导出格式随心所欲，你可以导出 HTML 格式的文件用来网站发布，也可以十分方便的导出 PDF 格式，这种格式写出的简历更能得到 HR 的好感。甚至可以利用 CloudApp 这种云服务工具直接上传至网页用来分享你的文章，全球最大的轻博客平台 Tumblr，也支持 Mou 这类 Markdown 工具的直接上传。

### Markdown 官方文档
> 这里可以看到官方的 Markdown 语法规则文档，当然，后文我也会用自己的方式阐述这些语法的具体用法。

* [*创始人 John Gruber 的 Markdown 语法说明*](http://daringfireball.net/projects/markdown/syntax)
* [*Markdown 中文版语法说明*](http://wowubuntu.com/markdown/#list)
### 使用 Markdown 的优点
* 专注你的文字内容而不是排版样式，安心写作。
* 轻松的导出 HTML、PDF 和本身的 .md 文件。
* 纯文本内容，兼容所有的文本编辑器与字处理软件。
* 随时修改你的文章版本，不必像字处理软件生成若干文件版本导致混乱。
* 可读、直观、学习成本低。

### 使用 Markdown 的误区
>We believe that writing is about content, about what you want to say – not about fancy formatting. 
>
> 我们坚信写作写的是内容，所思所想，而不是花样格式。
> 
— Ulysses for Mac

* Markdown 旨在简洁、高效，也由于 Markdown 的易读易写，人们用不同的编程语言实现了多个版本的解析器和生成器，这就导致了目前不同的 Markdown 工具集成了不同的功能（基础功能大致相同），例如流程图与时序图，复杂表格与复杂公式的呈现，虽然功能的丰富并没有什么本质的缺点，但终归有些背离初衷，何况在编写的过程中很费神，不如使用专业的工具撰写来的更有效率，所以如果你需实现复杂功能，专业的图形界面工具会更加方便。**当然，如果你对折腾这些不同客户端对 Markdown 的定制所带来高阶功能感到愉悦的话，那也是无可厚非的。**
 
  
### 我该用什么工具？
* Windows上，我我强烈建议你用 MarkdownPad2 这款十分好用的 Markdown **编辑器**，它支持**实时预览**，即左边是你编辑 Markdown 语言，右边会实时的生成预览效果。
* 不仅如此，MarkdownPad 支持多种 Markdown 解析引擎，包括 标准 Markdown 、 Markdown 扩展 (包括表格支持) 以及 GitHub 风格 Markdown 。

* 有了标签式多文档界面、PDF 导出、内置的图片上传工具、会话管理、拼写检查、自动保存、语法高亮以及内置的 CSS 管理器，您可以随心所欲地使用 MarkdownPad。
* 这个软件生成的代码比较纯正，而且生成的是百度蜘蛛能爬到的p标签，而不是br。

* 不过不太好的一点是像这种需要点两次回车。中间空行变大才是一个P标签。**调用图片极为方便，**具体方法可以到网上搜索教程。而且排版十分方便。

  经朋友描述，在她帮朋友用markdown排版文字，解决了在word里排版多空格问题时意外发现在这个软件中在每一段前打两个全角空格，就会出现首行缩进。

* 排出的版面出十分好看，在写好文章后右边会有预览。在复制的时候，你可以全选复制html代码，这样内容就干净多了。
###MarkdownPad2 pro注册码
 [推荐我是小黑，我要发发的博文](http://blog.csdn.net/xiaohei5188/article/details/43964451) 并感谢Soar的分享；
* 在 Mac OS X 上，笔者强烈建议你用 Mou 这款免费且十分好用的 Markdown 编辑器.

## 二，Markdown语法的简要规则
### 标题
标题是每篇文章都需要也是最常用的格式，在 Markdown 中，如果一段文字被定义为标题，只要在这段文字前加 # 号即可。

\' # 一级标题 

\' ## 二级标题

\' ### 三级标题

以此类推，总共六级标题，建议在井号后加一个空格，这是最标准的 Markdown 语法。

### 列表
熟悉 HTML 的同学肯定知道有序列表与无序列表的区别，在 Markdown 下，列表的显示只需要在文字前加上 - 或 * 即可变为无序列表，有序列表则直接在文字前加1. 2. 3. 符号要和文字之间加上一个字符的空格。

## 引用
如果你需要引用一小段别处的句子，那么就要用引用的格式。
> 例如这样
 
只需要在文本前加入 > 这种尖括号（大于号）即可

图片与链接
插入链接与插入图片的语法很像，区别在一个 !号
图片为：\\!\\[ ](){ImgCap}{/ImgCap}
链接为：\\[ ]( )

插入图片的地址需要图床，这里推荐围脖图床修复计划 与 CloudApp 的服务，生成URL地址即可。

###粗体与斜体
Markdown 的粗体和斜体也非常简单，用两个 \\* 包含一段文本就是粗体的语法，用一个 * 包含一段文本就是斜体的语法。

例如：**这里是粗体** 这里是斜体

###表格
表格是我觉得 Markdown 比较累人的地方，例子如下：
| Item      |    Value | Qty  |
| :-------- | --------:| :--: |
| Computer  | 1600 USD |  5   |
| Phone     |   12 USD |  12  |
| Pipe      |    1 USD | 234  |


这种语法生成的表格如下：

| Item      |    Value | Qty  |
| :-------- | --------:| :--: |
| Computer  | 1600 USD |  5   |
| Phone     |   12 USD |  12  |
| Pipe      |    1 USD | 234  |

###代码框
如果你是个程序猿，需要在文章里优雅的引用代码框，在 Markdown下实现也非常简单，只需要用两个 ``` 把中间的代码包裹起来。图例：

``` python
@requires_authorization
def somefunc(param1=\'\', param2=0):
    \'\'\'A docstring\'\'\'
    if param1 > param2: # interesting
        print \'Greater\'
    return (param2 - param1 + 1) or None
class SomeClass:
    pass

```
使用 tab 键即可缩进

###分割线
分割线的语法只需要三个 * 号，例如：
>到这里，Markdown 的基本语法在日常的使用中基本就没什么大问题了，只要多加练习，配合好用的工具，写起东西来肯定会行云流水。
>更多的语法规则，当markdown软件你第一次使用时，就会显示help文档。可以用来对用的查找和学习。[推荐：打开马克飞象](https://maxiang.io/)学起来更得心应手。

### LaTeX 公式

可以创建行内公式，例如 $\\Gamma(n) = (n-1)!\\quad\\forall n\\in\\mathbb N$。或者块级公式：

$$x = \\dfrac{-b \\pm \\sqrt{b^2 - 4ac}}{2a} $$

##三，相关推荐:
###工具
*图床工具用来上传图片获取 URL 地址*

* [Droplr](droplr.com)
* [Cloudapp](www.getcloudapp.com)
* [ezShare for Mac](https://itunes.apple.com/cn/app/yi-xiang/id672522335?mt=12&uo=4)
* [围脖图床修复计划](http://weibotuchuang.sinaapp.com)
###在线好用的Markdown工具，为印象笔记而生

* [马克飞象，专为印象笔记打造的Markdown编辑器，非常推荐](maxiang.io)