Markdown使用

Markdown指南

本质上，类似于html，markdown也是一种标记型语言，ie，用某些字符（不像html用字符串）标示某种格式，只是标记格式不同罢了。
比如：###Hello Word，标示出helloword是三级标题，markdown进行渲染后就成了对应大小、加粗的格式。
介绍markdown的教程太多了，我不打算做无用的重复，给出我认为必读的几个供大家参考。

1. 鲁塔弗：markdown 简明语法

2. 图灵社区：怎样使用Markdown

3. 简书：献给写作者的 Markdown 新手指南

4. 官方文档(中文版)：Markdown 语法说明

5. 用Markdown来书写你的博客

1markdown 简明语法

基本符号

· *,-,+ 3个符号效果都一样，这3个符号被称为 Markdown符号

· 空白行表示另起一个段落

· `是表示inline代码，tab是用来标记代码段，分别对应html的code，pre标签

换行

· 单一段落( <p>) 用一个空白行

· 连续两个空格会变成一个<br>

· 连续3个符号，然后是空行，表示 hr横线

标题

· 生成h1--h6,在文字前面加上 1--6个# 来实现

· 文字加粗是通过文字左右各两个符号

引用

· 在第一行加上 “>”和一个空格，表示代码引用，还可以嵌套

列表

这个是markdown文件的主要表示方式，主题要点化

· 使用*,+,-加上一个空格来表示

· 可以支持嵌套

· 有序列表用数字+英文点+空格来表示

· 列表内容很长，不需要手工输入换行符，css控制段落的宽度，会自动的缩放的

链接

· 直接写 [锚文本](url "可选的title")

· 引用先定义[ref_name]:url，然后在需要写入url的地方，这样使用[锚文本][ref_name]，通常的ref_name一般用数字表示，这样显得专业

· 简写url：用尖括号包裹url
这样生成的url锚文本就是url本身

插入图片

· 一行表示: ![alt_text](url "可选的title")

· 引用表示法: ![alt_text][id],预先定义 [id]:url "可选title"

· 直接使用<img>标签，这样可以指定图片的大小尺寸

特殊符号

· 用来转义，表示文本中的markdown符号

· 可以在文本种直接使用html标签，但是要注意在使用的时候，前后加上空行

· 文本前后各加一个符号，表示斜体

2怎样使用Markdown

图灵社区发帖采用的是流行的Markdown语法，本文可供快速入门。

代码1

单个回车

视为空格。

连续回车

才能分段。

行尾加两个空格，这里->

即可段内换行。

*这些文字显示为斜体*

**这些文字显示为粗体**

效果1

单个回车视为空格。

连续回车

才能分段。

行尾加两个空格，这里->
即可段内换行。

这些文字显示为斜体

这些文字显示为粗体

代码2

>表示引用文字内容。

#表示这是一级标题

##表示这是二级标题

###表示这是三级标题

……

###### 最小是六级标题

也可以这样表示大标题

这样表示小标题

效果2

表示引用文字内容。

表示这是一级标题

表示这是二级标题

表示这是三级标题

……

最小是六级标题

也可以这样表示大标题

这样表示小标题

代码3

---

上面是一条分隔线

- 这是无序列表项目

- 这是无序列表项目

- 这是无序列表项目

两个列表之间不能相邻，否则会解释为嵌套的列表

1. 这是有序列表项目

2. 这是有序列表项目

3. 这是有序列表项目

下面这个是嵌套的列表

- 外层列表项目

 + 内层列表项目

 + 内层无序列表项目

 + 内层列表项目

- 外层列表项目

效果

上面是一条分隔线

· 这是无序列表项目

两个列表之间不能相邻，否则会解释为嵌套的列表

1. 这是有序列表项目

2. 这是有序列表项目

3. 这是有序列表项目

下面这个是嵌套的列表

· 外层列表项目

· 内层列表项目

· 内层无序列表项目

· 内层列表项目

· 外层列表项目

代码4

直接把一个URL显示为超级连接：

也可以这样：[图灵社区](http://www.ituring.com.cn)

图像和链接非常类似，区别在开头加一个惊叹号： ![这是一个Logo图像](http://www.turingbook.com/Content/img/Turing.Gif)

此外，还可以以索引方式把url都列在文章的最后，例如这样：

[图灵社区][1]

![图灵社区Logo][2]

[1]:http://www.ituring.com.cn

[2]:http://www.ituring.com.cn/Content/img/Turing.Gif

效果4

直接把一个URL显示为超级连接：

也可以这样：图灵社区

图像和链接非常类似，区别在开头加一个惊叹号：

此外，还可以以索引方式把url都列在文章的最后，例如这样：

图灵社区

说明一下，上述1-3是并列关系，不同人总结的教程，建议都看。4比较繁琐，可以暂时不看，以后需要时再查询即可。
还有，markdown就这么点东西，学会了就一劳永逸了，性价比很高！

下面给出几个编辑器，大家边学边练。

· 简书用微博登录，开始记笔记吧！

· MaDe(Chrome插件)

· dillinger

· StackEdit 由TangPro推荐。

· Cmd - 在线 Markdown 编辑阅读器

好了，开始你的markdown之旅吧！

5 使用Markdown

5.1 简介

Markdown 的宗旨是实现「易读易写」。可读性，无论如何，都是最重要的。

Markdown 的语法全由一些符号所组成，这些符号经过精挑细选，其作用一目了然。格式撰写的文件可以直接以纯文本发布，并且看起来不会像是由许多标签或是格式指令所构成。

资料：[搭建环境]

5.2 基本语法

· 使用一个或多个空行分隔内容段来生成段落 <p>。

· 标题（h1~h6）格式为使用相应个数的“#”作前缀，比如以下代码表示 h3：

### this is a level-3 header ###

· 使用“>”作为段落前缀来标识引用文字段落。这其实是 email 中标记引用文字的标准方式：

> 引用的内容

> 这个记号直接借鉴的邮件标准

· 使用“*”“+”“-”来表示无序列表；使用数字加“.”表示有序列表。如：

1. I am ordered list item 1...

2. So I should be item 2!?

· 使用 4 个以上空格或 1 个以上的 tab 来标记代码段落，它们将被<pre> 和 <code> 包裹，这意味着代码段内的字体会是 monospace家族的，并且特殊符号不会被转义。

· 使用 [test](http://example.net"optional title") 来标记普通链接。

· 使用 ![img](http://example.net/img.png"optional title") 来标记图片。

引号内的 title 文字是可选的，链接也可以使用相对路径。

· 使用 * 或 _ 包裹文本产生 strong 效果：

_语气很重的文本_ 以及 **语气更重的文本**

让Markdown成为日常文本记录语言

习惯

日常记事中，用普遍文本的情况不在少数，但是文本本身的并没有特殊的格式含义，要表示一些特殊的含义也会在头或尾加一些*号，下划线，分割线等，来隔断文本块，区分内容信息等。那现在Markdown变得非常合适，只要稍微记住几个语法字符，就可以轻松的标记出来标题、段落、列表，长久使用形成习惯，能够带来很多方便。

所以可以把Markdown作为日常文档记录语言。

简单

markdown是一种轻量级的标记语言。语法简单，书写简单，只需要像写普通文本一样，在行首加上特殊的字符，就可以标记成标题，段落，列表，就是markdown。markdowng格式的文本，更容易阅读和理解，而且可以轻松转化成html，pdf等。详细标签说明见下面链接。

工具

使用Notepad,EditPlus,UltraEdit等等，只要可以写文本的编辑器都可以。让Notepad支持Markdonw语法高亮

1. 下载userDefineLang.xml

2. 将userDefineLang.xml 放置到此目录：C:UsersAdministratorAppDataRoamingNotepad++

3. 重启 Notepad++，在语言菜单下可以看到自定义的 Markdown 高亮规则

也可以使用现成的工具MarkdownPad，可以自动生成Markdown标签。