为知笔记 Markdown 新手指南
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 到 6个#，分别表示标题 1 到标题 6
# 这是标题1
## 这是标题1
###### 这是标题6
点击保存后的效果：
2. 有序列表
在行首增加 1.、2.、3.，即数字和英文句点, 不要求数字一定要连续，可以都是1.
1. 有序列表
1. 有序列表
4. 有序列表
点击保存后的效果：
3. 无序列表
在行首增加 * 或 -
* 无序列表
* 无序列表
点击保存后的效果：
4. 插入图片
可直接粘贴图片，或将图片文件拖动到光标处。
也可以使用标准的Markdown语法，如：
5. 插入链接
[描述](链接地址) ，例如：[为知笔记]()，注意要使用英文符号
点击保存后的效果：
6. 粗体、斜体、删除线
粗体：在文字前后添加 ** (注意符号与文字间不要有空格）
斜体：在文字前后添加 *
删除线：在文字前后添加 ~~
~~删除线~~
保存后的效果：
在文字前 添加 &
点击保存后的效果：
如果你无法简洁的表达你的想法，那只说明你还不够了解它。 -- 阿尔伯特·爱因斯坦
| 为知笔记|更新 | 版本 |
|------------|-----------|--------|
| WizNote | Markdown| Latest |
点击保存后的效果：
在代码前后增加 三个反单引号：```
int i = 0; i = 1;
for (int i = 0; i & 100; i++)
printf("hello markdown!\n");
保存后的效果：
如果需要指定语言， 在开头的``` 后紧跟具体语言，如: ```java
在任何你想要展示Markdown 笔记目录的地方，添加 [TOC] ， 在阅读模式下，标题1~6样式的内容会被提取出来作为目录，相当于大纲功能。
###Markdown 是什么
####Markdown 的好处
点击保存后的效果：
11. Mathjax 公式
可以创建行内公式，例如：$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$
或者块级公式，
$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$
点击保存后的效果：
12. 流程图
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)。
更多关于流程图的语法说明：
13. 时序图
```sequence
Alice-&Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob--&Alice: I am good thanks!
保存后效果：
更多关于时序图的语法说明：
根据搜索历史整理的相关关键词：markdown
mark down macdown markdwon markdowm makedown
marknote mardown walkdown workdown
欢迎到发帖讨论温馨提示！由于新浪微博认证机制调整，您的新浪微博帐号绑定已过期，请重新绑定！&&|&&
本人是个Linux和c语言爱好者,希望找到同样爱好的朋友一起学习
LOFTER精选
网易考拉推荐
用微信&&“扫一扫”
将文章分享到朋友圈。
用易信&&“扫一扫”
将文章分享到朋友圈。
阅读(594)|
用微信&&“扫一扫”
将文章分享到朋友圈。
用易信&&“扫一扫”
将文章分享到朋友圈。
历史上的今天
loftPermalink:'',
id:'fks_',
blogTitle:'Markdown简单语法介绍',
blogAbstract:'MARKDOWN简介
blogTag:'github,markdown',
blogUrl:'blog/static/',
isPublished:1,
istop:false,
modifyTime:0,
publishTime:8,
permalink:'blog/static/',
commentCount:0,
mainCommentCount:0,
recommendCount:0,
bsrk:-100,
publisherId:0,
recomBlogHome:false,
currentRecomBlog:false,
attachmentsFileIds:[],
groupInfo:{},
friendstatus:'none',
followstatus:'unFollow',
pubSucc:'',
visitorProvince:'',
visitorCity:'',
visitorNewUser:false,
postAddInfo:{},
mset:'000',
remindgoodnightblog:false,
isBlackVisitor:false,
isShowYodaoAd:false,
hostIntro:'本人是个Linux和c语言爱好者,希望找到同样爱好的朋友一起学习',
hmcon:'1',
selfRecomBlogCount:'0',
lofter_single:''
{list a as x}
{if x.moveFrom=='wap'}
{elseif x.moveFrom=='iphone'}
{elseif x.moveFrom=='android'}
{elseif x.moveFrom=='mobile'}
${a.selfIntro|escape}{if great260}${suplement}{/if}
{list a as x}
推荐过这篇日志的人：
{list a as x}
{if !!b&&b.length>0}
他们还推荐了：
{list b as y}
转载记录：
{list d as x}
{list a as x}
{list a as x}
{list a as x}
{list a as x}
{if x_index>4}{break}{/if}
${fn2(x.publishTime,'yyyy-MM-dd HH:mm:ss')}
{list a as x}
{if !!(blogDetail.preBlogPermalink)}
{if !!(blogDetail.nextBlogPermalink)}
{list a as x}
{if defined('newslist')&&newslist.length>0}
{list newslist as x}
{if x_index>7}{break}{/if}
{list a as x}
{var first_option =}
{list x.voteDetailList as voteToOption}
{if voteToOption==1}
{if first_option==false},{/if}&&“${b[voteToOption_index]}”&&
{if (x.role!="-1") },“我是${c[x.role]}”&&{/if}
&&&&&&&&${fn1(x.voteTime)}
{if x.userName==''}{/if}
网易公司版权所有&&
{list x.l as y}
{if defined('wl')}
{list wl as x}{/list}5836人阅读
Markdown（5）
简单介绍Markdown
Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成格式丰富的HTML页面。
—— 来自[]
简单的来说，Markdown就是用“标记符号”表示“格式”。Markdown语法标签与HTML语法标签是一一对应的，比如Markdown的二级标题标签##就对应着HTML中的&h2&...&/h2&标记，而且Markdown是兼容HTML语法的，如果你比较喜欢 HTML 的 &a& 或 &img& 标签，可以直接在Markdown文档中使用这些标记，而不用 Markdown 提供的链接或是图像标签语法。
CSDN Markdown编辑器是使用修改而来的，但在StackEdit的基础上做了一些细节优化，使得体验更加友好，CSDN Markdown支持的功能很多：
实时效果预览并自动滚动定位到编辑处（所见即所得）
支持 Markdown Extra / GitHub Flavored Markdown 扩展语法
支持代码语法高亮
支持 LaTeX 数学公式（基于 MathJax）
支持UML序列图和流程图
在线或离线管理多份 MarkDown 文档
支持离线编辑
支持导入在线和本地Markdown文档进行编辑
可以将编辑内容导出为 Markdown，HTML文件
管理已发布的文档
在这篇文章，我先介绍CSDN Markdown的基本语法，我会从Markdown语法说明、例子、与其对应的HTML语法、例子效果、注意事项这几个方面进行详细介绍。后面会继续介绍如何插入图片、CSDN Markdown的扩展语法、如何写数学公式和画图等相关的内容。
Markdown 支持两种形式的标题语法：和。
Setext 形式
Markdown语法说明：
Setext 形式是采用底线的方式，利用若干个 = （最高阶标题）和 - （第二阶标题）完成。
=============
-------------
对应的HTML语法：
&h1&这是标题1&/h1&
&h2&这是标题2&/h2&
注意事项：
这里#或-的数目是任意的，既可以写一个也可以写多个。
Markdown语法说明：
atx 形式则是在行首插入 1 到 6 个 # ，分别对应到标题 1 到 6 阶。
# 这是标题1
## 这是标题2
### 这是标题3
#### 这是标题4
##### 这是标题5
###### 这是标题6
转化为HTML后分别对应&h1&...&h6&这6个标记。
注意事项：
Setext形式的标题只能表示标题1和标题2这两阶，而atx形式的标题可以表示标题1~标题6共6阶。
上面#与文本之间的空格不是必需的，不加也可以，但加上是个好的习惯。
你可以选择性地「闭合」atx样式的标题，这纯粹只是美观用的，若是觉得这样看起来比较舒适，你就可以在行尾加上 #，而行尾的 # 数量也不用和开头一样（行首的#数量决定标题的阶数）。
Markdown语法说明：
Markdown标记区块引用是使用 & 标记，一个段落既可以只用一个 &标记（放在段首，属偷懒做法），也可以在一个段落的每一行前面加上 &。
& 这是一个区块引用。
与上面文本属于一个段落，因此这一行前面可以不加`&`标记。
& 由于上面空了一行，因此这是另一个不同的段落，前面的 `&`必须添加。
虽然这也是另一个不同的段落，但上面空行加了 `&`，因此这里段落之前的 `&`也可以省略，相当于上面空行的 `&`属于这个段落。
对应的HTML语法：
&blockquote&
&p&这是一个区块引用。
与上面文本属于一个段落，因此这一行前面可以不加`&`标记。&/p&
&p&由于上面空了一行，因此这是另一个不同的段落，前面的 `&`必须
添加。&/p&
&p&虽然这也是另一个不同的段落，但上面空行加了 `&`，因此这里段落之前的 `&`也可以省略，相当于上面空行的 `&`属于这个段落。&/p&
&/blockquote&
这是一个区块引用。
与上面文本属于一个段落，因此这一行前面可以不加&标记。
由于上面空了一行，因此这是另一个不同的段落，前面的 &必须添加。
虽然这也是另一个不同的段落，但上面空行加了 &，因此这里段落之前的 &也可以省略，相当于上面空行的 &属于这个段落。
注意事项：
区块引用可以嵌套使用，即引用内的引用，只要根据层次加上不同数量的 & 即可，比如两层就需要两个& ：
& 这是区块引用的第一层。
& & 这是嵌套引用，属于第二层，因此需要再加一个`&`，两个`&`之间的空格不是必需的。
& 回到区块引用的第一层。
这是区块引用的第一层。
这是嵌套引用，属于第二层，因此需要再加一个&，两个&之间的空格不是必需的。
回到区块引用的第一层。
引用的区块内也可以使用其他的Markdown语法，包括标题、列表、代码块等：
& ## 这是一个标题。
& 1. 这是第一个列表项。
& 2. 这是第二个列表项。
& 这是一个代码例子：
printf("Hello, Minmin!\n"); return 0;
这是一个标题。
这是第一个列表项。
这是第二个列表项。
这是一个代码例子：
printf("Hello, Minmin!\n"); return 0;
Markdown语法说明：
你可以在一行中用三个或以上的星号*、减号-、底线_来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立一条分隔线。
---------------------------------------
对应的HTML语法：
注意事项：
从上面例子可以看出，三个以上的标记之间允许存在空格，而且这三种标记可以混用，只要三种数量加起来大于等于3即可，比如下面这样：
我们知道在HTML中起到强调作用的有两个标签：&em&和&strong& ，关于两者的区别可以自行Google或看这篇文章「」，Markdown中也有这两种强调效果，使用的是星号*和底线_这两种标记。
Markdown语法说明：
使用一个 * 或 _ 来包围词句，相当于用 &em& 标签包围（内部就是这样转化的）；
使用两个 * 或 _ 包起来的话，则相当于使用 &strong&。
*使用一个星号的强调*
_使用一个 底线 的强调_
**使用两个星号的强调**
__使用两个底线 的强调__
对应的HTML语法：
&em&使用一个星号的强调&/em&
&em&使用一个底线的强调&/em&
&strong&使用两个星号的强调&/strong&
&strong&使用两个底线的强调&/strong&
使用一个星号的强调
使用一个底线的强调
使用两个星号的强调
使用两个底线 的强调
注意事项：
这里的**和__两个相同的符号中间不能留有空白，否则它们就只会被当成普通的符号。
注意&em&式的强调在不同的编辑器或浏览器里可能显示效果不一样，有的通过斜体来强调，有的通过下划点线来强调。
Markdown 支持有序列表和无序列表两种，且列表可以嵌套使用。
Markdown语法说明：
无序列表使用星号、加号或是减号作为列表标记，使用方法如下：
一个星号 / 一个加号 / 一个减号 + 若干个空格 + 列表项内容
这等同于：
也等同于：
对应的HTML语法：
&li&条目1&/li&
&li&条目2&/li&
&li&条目3&/li&
Markdown语法说明：
有序列表则直接使用数字作为列表标记，使用方法如下：
一个数字 + 一个英文句点 + 若干个空格 + 列表项内容
对应的HTML语法：
&li&第1点描述&/li&
&li&第2点描述&/li&
&li&第3点描述&/li&
（1）从有序列表所对应的HTML语法格式可以看出，你在有序列表标记上使用的数字并不会影响最终的按序输出，即如果你的列表标记写成：
或甚至是：
都会得到与上面完全相同的输出，你可以完全不用在意数字的正确性。
（2）列表标记后面一定要接着至少一个空格或制表符，否则就是普通的文本而非列表了，即下面的写法是列表不支持的：
（3）如果列表条目间用空行分开，那么在输出时两个条目之间也会有一个空行，而且若有多个条目，只要其中有一个空行，输出结果时所有条目之间都会出现空行，保持一致性。比如：
输出效果为：
（4）每个列表条目下都可以包含多个段落，但这些段落都必须缩进 4 个空格或 1 个制表符：
这是一个有两个段落的列表项，这是第一段。
这是第二段，段首已经缩进 4 个空格或 1 个制表符，否则就处在列表之外，自成一个普通段落，下面的列表条目也将自成另一个不同的列表，序号从1开始。
这是列表的第二个条目。
这是一个有两个段落的列表条目，这是第一段。
这是第二段，段首已经缩进 4 个空格或 1 个制表符，否则就处在列表之外，自成一个普通段落，下面的列表条目也将自成另一个不同的列表，序号从1开始。
这是列表的第二个条目。
（5） 如果要在列表条目内放进引用，那 & 就需要缩进：
含有引用的列表项，下面是引用元素：
& 这是一条引用。
& 前面需要缩进4个空格或1个制表符，跟段落一样。
含有引用的列表条目，下面是引用元素：
这是一条引用。
前面需要缩进4 个空格或 1 个制表符，跟段落一样。
（６）如果要在列表项内放代码区块的话，该区块就需要缩进两次，也就是8个空格或是2个制表符：
含有代码块的列表项：
#include &stdio.h&
int main(void) {
printf("Hello, Minmin!\n");
含有代码块的列表项：
#include &stdio.h&
int main(void) {
printf("Hello, Minmin!\n");
（7）避免产生不必要的列表项。
有时候，列表很可能会不小心产生，比如下面这样的写法：
1986. 这不是一个列表项。
也会产生一个下面这样的列表：
这不是一个列表项。
换句话说，也就是在行首出现数字-句点-空白，要避免这样的状况，你可以在句点前面加上反斜杠，具体可以查看后面的「 」一节。
1986\. 这不是一个列表项。
这样就对了：
1986. 这不是一个列表项。
Markdown的链接可分为自动链接和普通文本链接两种类型。
自动链接（可点击的URL和Email）
Markdown支持以比较简短的自动链接形式来处理网址和电子邮件信箱。
Markdown语法说明：
对于本身是个URL和Email的文本来说，只要是用尖括号包起来，Markdown就会自动把它转成链接。
这是一个可点击的URL：
&http://www.csdn.net/&
这是一个可点击的Email：
对应的HTML语法：
对于上面普通的URL，Markdown会转成下面的HTML语法：
&a href="http://www.csdn.net/"&http://www.csdn.net/&/a&
而对于Email的自动链接也很类似，只是Markdown会先做一个编码转换的过程，把文字字符转成 16 进位码的 HTML 实体，这样的格式可以糊弄一些不好的邮址收集机器人，例如对于上面的Email，Markdown 会转成：
&a href="mailto:addre
ss@example.co
m"&address@exa
mple.com&/a&
在浏览器里面，这段字串会最终转成下面的HTML语法：
这是一个可点击的URL：
这是一个可点击的Email：
注意事项：
对于邮件的自动链接，使用Markdown语法虽然可以糊弄不少的机器人，但并不能全部挡下来，不过总比什么都不做好些。不管怎样，公开你的信箱终究会引来广告信件的。
普通文本链接
Markdown支持两种形式的普通文本链接语法： 行内式和参考式两种形式。
行内式链接
Markdown语法说明：
下面三种语法形式都是允许的：
[链接文字](链接URL '可选的链接title')
[链接文字](链接URL "可选的链接title")
[链接文字](链接URL (可选的链接title))
详细说明就是：
一个方括号，里面输入链接文本；
接着一个圆括号，里面可以包含两部分内容，中间用空格隔开：
【必须】链接的网址；
【可选】链接的title文字，只要用单引号、双引号或是括弧把title文字包起来即可，加上title后，你用鼠标移到该链接文字时就会显示title文字，可以把它当作一种提示信息来用，当然你也可以不用title属性。
更多精彩的内容，可以访问[敏敏的CSDN博客](http://blog.csdn.net/lanxuezaipiao/ "敏敏的博客")（有title属性） 。
想更多的了解敏敏，可以访问[敏敏的新浪微博](/lanxuezaipiao/) （无title属性）。
对应的HTML语法：
&p&更多精彩的内容，可以访问 &a href="http://blog.csdn.net/lanxuezaipiao/" title="敏敏的博客"&敏敏的CSDN博客&/a&（有title属性） 。&/p&
&p&想更多的了解敏敏，可以访问&a href="/lanxuezaipiao/"&敏敏的新浪微博&/a& （无title属性）。&/p&
更多精彩的内容，可以访问 （有title属性）。
想更多的了解敏敏，可以访问 （无title属性）。
注意事项：
如果你是要链接到同一个主机的资源，可以使用相对路径，例如：
想要进一步了解，请访问 [About](/about/) 页。
参考式链接
Markdown语法说明：
[链接文字][链接id]
[链接id]: 真正的链接URL "可选的title"
可以发现参考式的链接中链接文字的后面不是一个圆括号而是另一个方括号，在该方括号里面要填入用以辨识链接的标记，注意两个方括号之间允许有空格，接着，在文档的任意处，你可以把这个标记的链接内容定义出来。
链接内容定义的形式为：
一个方括号（前面可以选择性地加上至多三个空格来缩进），里面输入上面的链接id
接着一个冒号
接着一个以上的空格或制表符
接着链接的网址
选择性地接着 title 内容，可以用单引号、双引号或是括弧包着，与上面一样
想知道敏敏都读过哪些书、看过哪些电影吗？请进入[敏敏的豆瓣][id]来了解下吧。
[id]: /people//
"敏敏的豆瓣"
对应的HTML语法：
&p&想知道敏敏都读过哪些书、看过哪些电影吗？请进入&a href="http://blog.csdn.net/lanxuezaipiao/" title="敏敏的豆瓣"&敏敏的豆瓣&/a&来了解下吧。&/p&
想知道敏敏都读过哪些书、看过哪些电影吗？请进入来了解下吧。
注意事项：
（1）有一个已知的问题是 Markdown.pl 1.0.1 会忽略单引号包起来的链接 title，因此大家在使用时尽量选择用双引号或括弧，避免出错。
（2） 链接网址也可以用尖括号包起来，如：
[id]: &/people//&
"敏敏的豆瓣"
（3）你也可以把 title 属性放到下一行，也可以加一些缩进，若网址太长的话，这样会比较好看：
[id]: http://blog.csdn.net/lanxuezaipiao/article/details/
"敏敏的2014年总结"
（4）网址定义只有在产生链接的时候用到，并不会直接出现在文件之中，如上面的效果中没有出现[id]:这样的网址定义。
（5）链接辨别标签可以有字母、数字、空白和标点符号，但是并不区分大小写，因此下面两个链接是一样的：
[链接文本][a]
[链接文本][A]
（6）还有一种隐式链接标记功能，可以让你省略指定链接标记，这种情形下，链接标记会视为等同于链接文字，要用隐式链接标记只要在链接文字后面加上一个空的方括号，如果你要让 “Google” 链接到 ，你可以简化成：
[Google][]
然后定义链接内容：
[Google]: /
（7）链接的定义可以放在文件中的任何一个地方，我比较偏好直接放在链接出现段落的后面，你也可以把它放在文件最后面，就像是注解一样。
下面给出一个综合性的范例，来比较下这几种链接方式的差异：
采用行内式链接的方式：
我经常逛的网站或社区有： [CSDN](http://www.csdn.net/ "CSDN")、[知乎] (/ "知乎")还有[豆瓣](/
采用参考式链接的方式：
我经常逛的网站或社区有： [CSDN] [1]、[知乎] [2] 还有[豆瓣] [3]。
[1]: http://www.csdn.net/
采用链接名称的方式：
我经常逛的网站或社区有： [CSDN] []、[知乎] [] 还有[豆瓣] []。
[csdn]: http://www.csdn.net/
上面三种写法产生的效果都一样：
我经常逛的网站或社区有： 、 还有。
那么现在一个问题来了：这三种写法到底该如何选用呢？哪种写法最好？
我个人认为这是自己的喜好问题，你看哪个写的舒服就选用哪个方法？不过从官方来看，较推荐参考式的链接写法。参考式的链接其实重点不在于它比较好写，而是它比较好读，比较一下上面的范例，使用参考式的文章本身读起来很简洁（因为链接标记单独成段了），但是用行内形式的看起来就很臃肿，还容易看错。
使用 Markdown 的参考式链接，可以让文件更像是浏览器最后产生的结果，让你可以把一些标记相关的元数据移到段落文字之外，你就可以增加链接而不让文章的阅读感觉被打断。
关于Markdown的代码语法，下面分为行内代码和代码区块两类来说明。
Markdown语法说明：
如果要标记一小段行内代码，你可以用反引号(就是跟~在一起的那个按键)把它包起来（`）即可：
`你要标记的行内代码`
让我们看看`printf()` 函数有哪些参数。
对应的HTML语法：
&p&让我们看看&code&printf()&/code& 函数有哪些参数。&/p&
让我们看看printf() 函数有哪些参数。
注意事项：
如果要在行代码段内插入反引号，你可以用多个反引号来开启和结束代码段：
这是一个反引号 (`)。
就能正常输出反引号：
这是一个反引号 (`)。
如果要在代码段的起始处或结尾处插入一个正常的反引号，这时会有连续三个反引号连在一块的情况，且达不到想要的效果。这时就需要在代码段的起始和结束端各放入一个空白，起始端后面一个，结束端前面一个，例如：
这是代码片段中的反引号：`
这样就能产生想要的效果：
这是代码片段中的反引号：`
和程序相关的写作通常会有已经排版好的代码区块，通常这些区块我们并不希望它以一般段落文件的方式去排版（如果用一般段落的方式那么段首所有的空格都被消除了），而是照原来的样子显示，Markdown 会用 &pre& 和 &code& 标签来把代码区块包起来。
Markdown语法说明：
要在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以。
这是一个普通段落：
这是一个代码区块。
对应的HTML语法：
&p&这是一个普通段落：&/p&
&pre&&code&这是一个代码区块。
&/code&&/pre&
这个每行一阶的缩进（4 个空格或是 1 个制表符），都会被移除，举一个具体的代码实例。
下面是一个简单的Java实例：
public class Test{
public static void main (String[] args){
System.out.println("欢迎访问lanxuezaipiao！");
下面是一个简单的Java实例：
public class Test{
public static void main (String[] args){
System.out.println("欢迎访问lanxuezaipiao！");
注意事项：
在代码区块中，一般的 Markdown 语法不会被转换，像是星号便只是星号，即用两个星号将一句话包围起来也不会转化为强调，这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文件，不用担心代码中包含一些特殊的Markdown语法标记。
反斜杠的用处
Markdown可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果，你可以在星号的前面加上反斜杠：
\*重点描述文本\*
效果就是：*重点描述文本*
Markdown支持以下这些符号前面加上反斜杠来帮助插入普通的符号而非Markdown语法标签：
问题1：Markdown如何添加多个空行？
我们知道Markdown的段落是由前后各一个空行形成，人为的添加多个空行会被Markdown语法自动忽略仅剩一个空行，这是比较人性化的，因为不需要人为删除一些多余的空行了。但两个段落之间也有需要多个空行的情况，比如上面给出一些谜题，谜底一般放在最下面，中间需要大部分的留白，这时候就需要借助HTML换行标签来达到这个目的了（前面已经提过Markdown语法是兼容HTML的）：即在需要空行的地方插入 &br /& 标签或 &p& 标签。
大家如果有其它任何问题，可以在下面留言，我会将大家提问的问题都整理到这里来。
参考知识库
* 以上用户言论只代表其个人观点，不代表CSDN网站的观点或立场
以前的博客，虽已不再更新，但某些文章也值得参考滴：
生活、读书、感悟等非技术性文章，请移步至我的简书博客：
收藏了很多读书和电影条目，基本上都有自己的评鉴语：
微信学习公众平台-媛媛推荐
微信号：programer-idea
名称：程序媛想事儿
访问：560079次
积分：8530
积分：8530
排名：第1713名
原创：124篇
转载：14篇
评论：1029条
阅读：43599
文章：16篇
阅读：83081
阅读：33549
(1)(1)(1)(2)(3)(9)(5)(18)(4)(8)(4)(4)(5)(1)(7)(4)(22)(14)(10)(5)(11)(2)(1)