tags: Markdown tags && syngx

###Markdown 是什么
Markdown 是一种轻量级标记语言，创始人为约翰·格鲁伯（John Gruber）。它允许人们「使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML(或者HTML)文档」—— 维基百科
如果你看不懂以上维基百科对 Markdown 的定义，就当这段掐了没播。约翰·格鲁伯自己对Markdown的描述的重点也在于「easy-to-read，easy-to-write」。

###那么到底 easy 在哪里呢？
虽然称作「标记语言」，但简单理解 Markdown 就是在文本前增加符号来表示文本格式。你不需要关心标题多大号，列表缩进多少，是否对齐，只要使用了同一种符号标记，Markdown 已经帮你做好了排版。

###Markdown 的好处
编辑，不用操心排版你只需要把注意力放在内容上。笔者在用 Markdown 之前，打开word 先想想，标题用啥字体呢，几号字呢？不知不觉我的意志力就被消耗了。实际上所谓排版，不就是作者的思路以及内容的层级和结构么，在学会使用 Markdown 之后，几个简单的符号就把这些事儿搞定，样式还特别工整精美。
修改，不用担心排版想想那些你在同事之间改来改去的 word 文档吧，如果哪位童鞋从外部粘贴了一段带格式的文字，那么你再次打开文档时会发现整个人都不好了：格式被改的乱七八糟，还要重新调整。如果用 Markdown 群组笔记，想改哪里改哪里，根本不用担心格式，改完评论里直接 @TA，多轻松！
一句话来说，Markdown 是用最简单的方式，零排版成本，写出布局工整、阅读舒适的笔记。减少干扰，降低成本，提高效率，不管在什么设备上，看起来都是一个工整的样子。不仅自己阅读爽，分享给朋友也有面儿不是~

###那些牛人都在用
阳志平在 2012 年就发博客推崇了一下 Markdown，但那篇文章虽解读深刻，但也略显极客，把Markdown 不仅能排版，能做流程图，还支持数学公式的特性介绍了一遍，连科技论文都要选择 Markdown 都涉猎到了。有兴趣阅读的童鞋可点击这里查看。
很多在线博客和内容社区都提供 Markdown 编辑器，不仅在阅读上带来了舒适、统一、美好的体验，每一个参与写作的人，也能够毫不费力地写出排版整齐的文章来。

###如何在为知笔记上创建 Markdown 笔记
为知笔记所有客户端都支持 Markdown ，有两种方法可以创建 Markdown 笔记

######第一种：在笔记标题后面加 .md ，编辑并保存后，即可看到渲染后的效果

######第二种：在移动端直接创建 Markdown 笔记
编辑完成后，点击「保存」按钮，即可看到格式精美的笔记啦！

######来个小技巧
不管我再怎么说 Markdown 的语法记忆负担小、简单，在最初你都会有点儿晕。在这里给大家分享个小技巧：
最初只需要记住 # 标题一、## 标题二、1. 第一点、这一点，用这几个写写日志、需求文档、小文章，排版上足够了；
逐渐的你发现有些文字需要重点指出，那么还可以使用加粗、斜体* 来对文字做重点说明；
如果你是名程序员，那么可以用

> 可以做引用；

学生的话，就去了解一下 LaTex 吧，为知笔记 Markdown 支持 Mathjax 公式渲染哦~
Markdown 格式标记符号说明
1. 标题
在行首插入 1 到 6个#，分别表示标题 1 到标题 6
# 这是标题1
## 这是标题1
###### 这是标题6
点击保存后的效果：
2. 有序列表
在行首增加 1.、2.、3.，即数字和英文句点, 不要求数字一定要连续，可以都是1.
1. 有序列表
1. 有序列表
4. 有序列表
3. 无序列表
在行首增加 * 或 -
* 无序列表
* 无序列表
4. 插入图片
可直接粘贴图片，或将图片文件拖动到光标处。
也可以使用标准的Markdown语法，如：
 ![](http://cdn.wiz.cn/wp-content/uploads/2015/06/wiz_logo.png)
5. 插入链接
[描述](链接地址) ，例如：[为知笔记](http://www.wiz.cn)，注意要使用英文符号
6. 粗体、斜体、删除线
粗体：在文字前后添加 ** (注意符号与文字间不要有空格）
斜体：在文字前后添加 *
删除线：在文字前后添加 ~~
**粗体**
*斜体*
~~删除线~~
7. 引用
在文字前 添加 >
>如果你无法简洁的表达你的想法，那只说明你还不够了解它。 -- 阿尔伯特·爱因斯坦
8. 表格
| 为知笔记|更新 | 版本 |
|------------|-----------|--------|
| WizNote | Markdown| Latest |
9. 代码
在代码前后增加 三个反单引号：

int i = 0; i = 1; 
for (int i = 0; i < 100; i++)
{
      printf("hello markdown!\n");
}

目录
在任何你想要展示Markdown 笔记目录的地方，添加 [TOC] ，在阅读模式下，标题1~6样式的内容会被提取出来作为目录，相当于大纲功能。
例如：
[TOC]
###Markdown 是什么
####Markdown 的好处
Mathjax 公式
可以创建行内公式，例如：$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$
或者块级公式，
$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

流程图

st=>start: Start
e=>end: End
op1=>operation: My Operation
sub1=>subroutine: My Subroutine
cond=>condition: Yes or No?
io=>inputoutput: catch something...
st->op1->cond
cond(yes)->io->e
cond(no)->sub1(right)->op1

注意：
1) 关键词（start、end、operation、subroutine、condition和inputoutput）后的冒号后要紧跟一个空格。
2) 使用->来连接两个元素，对于condition类型，有yes和no两个分支，如示例中的cond(yes)和cond(no)。
更多关于流程图的语法说明：http://adrai.github.io/flowchart.js/

时序图

1
2
3

Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob-->Alice: I am good thanks!

更多关于时序图的语法说明：http://bramp.github.io/js-sequence-diagrams/

#Markdown——入门指南

###Te_Lee 2014-04-17 21:14

######转载请注明原作者，如果你觉得这篇文章对你有帮助或启发，也可以来请我喝咖啡。

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

###Ulysses for Mac

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

###Markdown 官方文档
这里可以看到官方的 Markdown 语法规则文档，当然，后文我也会用自己的方式阐述这些语法的具体用法。
创始人 John Gruber 的 Markdown 语法说明Markdown 中文版语法说明

####使用 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 的定制所带来高阶功能感到愉悦的话，那也是无可厚非的。
flowchart.js on Github（使用 Markdown 绘制流程图）
我该用什么工具？

######Mou for Mac
在 Mac OS X 上，我强烈建议你用 Mou 这款免费且十分好用的 Markdown 编辑器，它支持实时预览，既左边是你编辑 Markdown 语言，右边会实时的生成预览效果。不仅如此，Mou 还有一些有趣的偏好设置（Preference），例如主题（Themes）与样式（CSS），它们可以配置出定制化的文本编辑效果与导出效果，如果你对自带的主题与样式不满意还可以到 GitHub 上搜索其它爱好者为 Mou 编写的更多主题样式，导入的方式可以在偏好设置的 Themes 或 CSS 选项中选择 reload。

######Mou 的编写与预览窗口
如果你从事文字工作，我强烈建议你购买 Ulysses for Mac，这款软件入围了苹果 Mac App Store 的 The Best of 2013。它支持更多的写作格式、多文档的支持。Mou，iA writer 这些软件都是基于单文档的管理方式，而 Ulysses 支持 Folder、Filter 的管理，一个 Folder 里面可以创建多个 Sheet，Sheet 之间也可以进行 Combine 处理。
Mac 上一些 Markdown 编辑器
由于笔者很少接触 Windows，Windows 下的 Markdown 没有过多涉猎，经朋友介绍，有两款还算不错，一款叫做 MarkdownPad ，另一款叫做 MarkPad。
iOS 端很多 app 早已经支持了 Markdown 录入，例如 Drafts，Day One，iA writer 等，另外 Ulysses for iPad 现在已经上架，可以说是 iOS 平台最好的编辑器了。
在 Web端，我强烈推荐简书这款产品，上面有无数热爱文字的人在不停的创造，分享。在 Web 端使用 Markdown 没有比简书更舒服的地方了，同样支持左右两栏的实时预览，字体优雅，简洁。
简书的编辑预览模式

##二，Markdown 语法的简要规则

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

一级标题

二级标题

三级标题

以此类推，总共六级标题，建议在井号后加一个空格，这是最标准的 Markdown 语法。
列表熟悉 HTML 的同学肯定知道有序列表与无序列表的区别，在 Markdown 下，列表的显示只需要在文字前加上 - 或 * 即可变为无序列表，有序列表则直接在文字前加1. 2. 3. 符号要和文字之间加上一个字符的空格。
无序列表与有序列表
引用
如果你需要引用一小段别处的句子，那么就要用引用的格式。
例如这样
只需要在文本前加入 > 这种尖括号（大于号）即可
引用

####图片与链接
插入链接与插入图片的语法很像，区别在一个 !号

####图片为：{ImgCap}{/ImgCap}

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

####URL 与图片

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

####表格
表格是我觉得 Markdown 比较累人的地方，例子如下：
| Tables | Are | Cool |
| ————- |:—————:| —–: |
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |

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

####使用 tab 键即可缩进。

####分割线

####分割线的语法只需要三个 * 号，例如：
到这里，Markdown 的基本语法在日常的使用中基本就没什么大问题了，只要多加练习，配合好用的工具，写起东西来肯定会行云流水。更多的语法规则，其实 Mou 的 Help 文档栗子很好，当你第一次使用 Mou 时，就会显示该文档。可以用来对用的查找和学习。

#####本文首发在少数派转载请注明原作者，如果你觉得这篇文章对你有帮助或启发，也可以来请我喝咖啡。

######利益相关：本篇文章所有涉及到的软件均为笔者日常所用工具，无任何广告费用。

##著作权归作者所有

#Markdown 11种基本语法
现在是我在学习Markdown时做的笔记。学完这些Markdown的基本使用已经不成问题。

##标题设置（让字体变大，和word的标题意思一样）

1. 在Markdown当中设置标题，有两种方式：

######第一种：通过在文字下方添加“=”和“-”，他们分别表示一级标题和二级标题。

######第二种：在文字开头加上 “#”，通过“#”数量表示几级标题。（一共只有1~6级标题，1级标题字体最大）

2. 块注释（blockquote）

####通过在文字开头添加“>”表示块注释。（当>和文字之间添加五个blank时，块注释的文字会有变化。）

3. 斜体

####将需要设置为斜体的文字两端使用1个“*”或者“_”夹起来

4. 粗体

####将需要设置为斜体的文字两端使用2个“*”或者“_”夹起来

5. 无序列表

####在文字开头添加(, +, and -)实现无序列表。但是要注意在(, +, and -)和文字之间需要添加空格。（建议：一个文档中只是用一种无序列表的表示方式）

6. 有序列表

####使用数字后面跟上句号。（还要有空格）

7. 链接（Links）

####Markdown中有两种方式，实现链接，分别为内联方式和引用方式。

####内联方式：This is an example link.

##引用方式：
I get 10 times more traffic from Google than from Yahoo or MSN.

图片（Images）
图片的处理方式和链接的处理方式，非常的类似。
内联方式：
引用方式：

代码（HTML中所谓的Code）
实现方式有两种：
第一种：简单文字出现一个代码框。使用
。（不是单引号而是左上角的ESC下面~中的）
第二种：大片文字需要实现代码框。使用Tab和四个空格。
脚注（footnote）
实现方式如下：
hello^hello

1. 下划线
  在空白行下方添加三条“-”横线。（前面讲过在文字下方添加“-”，实现的2级标题）
  References：
  以上内容根据官方文档基本文档进行整理。http://daringfireball.net/projects/markdown/basics
  Markdown官方网站：http://daringfireball.net/projects/markdown/ ;
  推荐一款在线的Markdown编辑器：https://stackedit.io/

Markdown 是什么