Markdown新手入门

Markdown is a lightweight markup language with plain text formatting syntax

Markdown的优点

• 专注于写作的内容，而不是排版的样式

• 可读性高，学习成本低

• 纯文本内容，兼容性好

• 可以很方便的导出成HTML文本和PDF文件

• 可以使用Git进行版本控制

好用的Markdown软件

• Mou这是推荐使用最多的Markdown软件，但是悲催的是最新的Sierra版本有Bug，据说好像Mou团队已经不维护这个项目了。

• Typora是我自己用的软件，这个软件最大的特点是简单并且功能很强大，而且开源和跨平台。我自己用下来发现最大的优点就是写的时候自动转换格式，不用两列的预览方式。而且看起来很干净。

• MacDown是一款开源的Mac平台下的Markdown编辑器

• iA Writer

• Typed

• Byword

• 还有什么好的Markdown欢迎推荐哟！

Markdown的语法

• 兼容HTML
这个语法特点与 Markdown 语言的初衷有关，Markdown就是希望成为适应于网络的书写语言。
在写一些常见的区块元素(例如: <div> 、<table>、<p>)的时候要注意必须在前后加上空格将其区分开来，并且要求他它们开始和结束的标签不能用空格或者制表符来缩进。
下面是一段html语法的表格

<table>
	<tr>
		<td>Foo</td>
	</tr>
</table>复制代码

请注意在上面HTML区块中的Markdown语法不会被转换的。比如你在HTML区块中使用Markdown样式的**强调**是没有加粗效果的。
如果不希望某个Markdown语法的关键词自动转化样式，可以在字符前面加\转义

区块元素

1.标题

2.区块引用

• 在每行前面加上>

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> This is a block title复制代码

• 区块引用可以嵌套

> > > This is a nested blockquote复制代码

• 区块引用支持其他Markdown语法

> ## This is a h2 title
> **strong**复制代码

3.列表

• 有序列表
规则是数字+英文句号+空格

1. Apple
2. Pear
3. Banana复制代码

如果你写成了

1. Apple
1. Pear
1. Banana复制代码

或者甚至是

6. Apple
3. Pear
2. Banana复制代码

其实上面的结果都是一样的，都是转化为第一个，建议还是从第一个按顺序写，说不定什么时候Markdown就支持了有序列表的start属性。
当然有时候会不小心产生有序列表
2018. This is a grate year
解决方法在前面中提到过，就是在英文逗号前加个转义字符\，这样就避免了自动转义的问题。
2018\. This is a greate year

• 无序列表
使用星号(*)、加号(+)、减号(-)作为列表标记

* Red
* Black
* Blue
等同于:
+ Red
+ Block
+ Blue
也等同于:
- Red
- Black
- Blue复制代码

4.代码块

• 块代码
```表示代码块，其语法example如下：

```c++
#include <iostream>#include <cstdio>using namespace std;
int main(){
  int a, b;
  cin>>a>>b;
  cout<<a+b<<endl;
}
```复制代码

• 行内代码块
`表示行内代码块

`This is inline codequote example`复制代码

5.分割线

***

* * *

---

- - -复制代码

6.表格

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | center        | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |
| default left  |  python       | right |复制代码

区段元素

1.连接

• 行内式
行内式的Markdown语法[链接文本](链接)，如果还需要加上链接的标题的话直接在链接后面用引号或者括号包裹标题
Examples:
[Dior](http://www.todaycoder.cn)
This is [an example](http://www.todaycoder.cn) link.
This is [an example](http://www.todaycoder.cn "dior") has title attribute.

• 参考式
参考式的Markdown语法[链接文本][链接标记]，后面再加上[链接标记]: 链接，其实这两部是不分先后顺序的，建议把这些链接统一写在文章的底部，这样也便于统一管理和修改。
Examples

[Example][id]
[id]: http://www.todaycoder.cn "example"
[id]: http://www.todaycoder.cn 'example'
[id]: http://www.todaycoder.cn (example)复制代码

[Google][]
[Google]: http://www.google.com
或者
[Google][0]
[0]: http://www.google.com复制代码

下面三种例子以供大家参考：
参考式链接

I get 10 times more traffic from [Google] [1] than from [Yahoo] [2] or [MSN] [3].
[1]: http://google.com/        "Google"
[2]: http://search.yahoo.com/  "Yahoo Search"
[3]: http://search.msn.com/    "MSN Search"复制代码

链接名称

I get 10 times more traffic from [Google][] than from [Yahoo][] or [MSN][].
[google]: http://google.com/        "Google"
[yahoo]:  http://search.yahoo.com/  "Yahoo Search"
[msn]:    http://search.msn.com/    "MSN Search"复制代码

行内式

I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").复制代码

大家可以根据具体需求自己选择，如果链接很多的话建议使用上面两种方法

2.图片

![图片已损坏](/path/img/img.jpg  'title')

![iamge hsa broken](/path/img/img.png  "title")

![image][id]
[id]: /paht/img/img.png (title)

![image][]
[image]: /path/img/img.png复制代码