Markdown 是一种轻量级「标记语言」,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。 --维基百科
Markdown通常为程序员与专注于写作的群体所用。
不要被「标记语言」这个说法吓到,这一点也不难。它实际上是个非常简单、非常容易学习的语法。这个语法简单到每个人都可以在半天以内掌握。因此学习成本并不高,且一旦熟悉这种语法规则,会有一劳永逸的效果。应该是为数不多,你真的可以彻底学会的语言。
正如您在阅读的这份文档,它使用简单的符号标识不同的标题,将某些文字标记为粗体或者斜体,创建一个链接。是不是简单又实用呢?让写作变得更简单,我们不用再考虑如何排版,我们只要专心于写作就好了,这也是Markdown的宗旨!!!
- 分级标题
- 区块引用
- 分隔线
- 强调
- 列表
- 表格
- 超链接
- 锚点
- 图片
- 图片行内式
- 图片参考式
- 注脚
- 代码
- 代码行内式
- 缩进式多行代码
- 用六个`包裹多行代码
- HTML 原始码
- 实用指南
- 待办事项清单
- 更新ing
以下为整理归纳的语法。学完这些Markdown的基本使用已经不成问题。
常言道:看书先看皮,看报先看题,标题可以使读者了解到文章的主要内容和主旨。
在Markdown当中设置标题,有两种方式:
第一种:通过在文字下方添加“=”和“-”,他们分别表示一级标题和二级标题。
这是一个一级标题
====================
这是一个二级标题
-------------------------------------
第二种:在文字开头加上 “#”,通过“#”数量表示几级标题。(一共只有1~6级标题,1级标题字体最大)
注意:为避免兼容性问题,#后面请保留一个空格再加上文字。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
区块引用需要在被引用的文本前加上>符号。
>这是一个区块引用实例;
>也称为块注释(blockquote)
> (当>和文字之间添加五个blank时,块注释的文字会有变化。)
这是一个区块引用实例;
也称为块注释(blockquote)
(当>和文字之间添加五个blank时,块注释的文字会有变化。)
Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :
> 业精于勤,
荒于嬉;
> 行成于思,
毁于随.
业精于勤, 荒于嬉;
行成于思, 毁于随.
读者可以试一试以下将会是何种效果?
> 业精于勤,
荒于嬉;
行成于思,(此处开头不添加>,并且上一行为空行)
毁于随.
区块引用可以嵌套(例如:引用内的引用), 只要根据层次加上不同数量的 >:
>>> Hello World !
>> Github
> Markdown此处还应注意空行
Hello World !
Github
Markdown此处还应注意空行
引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:
> - 天道酬勤
>
> - deardirks
>
> - 给出一些例子代码:
> ```markdown
> return debug_backtrace();
> ```
天道酬勤
deardirks
给出一些例子代码:
return debug_backtrace();
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线, 行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
* * *
***
*****
- - -
---------------------------------------Markdown 使用星号*和底线_作为标记强调字词的符号。
*Markdown*Markdown
**Markdown**Markdown
~~Markdown~~
Markdown
久而久之,你发现标题不适合做列表,于是用1. 第一点、- 这一点来列表超级方便。
在文字开头添加(*, +, -)实现无序列表。但是要注意在(*, +, -)和文字之间需要添加空格。(建议:一个文档中只是用一种无序列表的表示方式)
- 我是一个无序列表
- 我是一个小圆点
- 我还有二级列表哦
- 我是一个无序列表
- 我是一个小圆点
- 我还有二级列表哦
使用数字后面跟上英文的句号。(还要有空格)
1. 我是一个有序列表
2. 皮一下我还是很开心的~
- 我是一个有序列表
- 皮一下我还是很开心的~
如果要在列表项目内放进引用,那 > 就需要缩进:
* **《赠别·其一》** 作者:*杜牧*:
> 娉娉袅袅十三余,豆蔻梢头二月初。
> 春风十里扬州路,卷上珠帘总不如。- 《赠别·其一》 作者:杜牧:
娉娉袅袅十三余,豆蔻梢头二月初。 春风十里扬州路,卷上珠帘总不如。
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式, 行内式一般使用较多。
[]里写链接文字,()里写链接地址,()中的""中可以为链接指定title属性,title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字。
即[链接文字](链接地址 "链接标题") 这样的形式。链接地址与链接标题前有一个空格。
[Markdown Syntax](https://github.com/deardirks)
[Markdown Syntax](https://github.com/deardirks "deardirks")参考式超链接一般用在学术论文上面, 或者另一种情况, 如果某一个链接在文章中多处使用, 那么使用引用的方式创建链接将非常好, 它可以让你对链接进行统一的管理。
参考式链接分为两部分, 文中的写法 [链接文字][链接标记],在文本的任意位置添加 [链接标记]:链接地址 "链接标题", 链接地址与链接标题前有一个空格。
全球最大的搜索引擎网站是[Google][1]。
[1]:http://www.google.com "Google"全球最大的搜索引擎网站是 Google。
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱, 只要是用 <> 包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样, 例如:
<https://google.com/>
<deardirks@gmail.com>https://google.com/
锚点其实就是一个独立页面内的超链接,也就是链接本文档内部的某些元素, 实现当前页面中的跳转。比如我这里写下一个锚点, 点击**回到目录**, 就能跳转到目录。 在目录中点击锚点,又能跳转过来。还有下一节的注脚。这些根本上都是用锚点来实现的。
//首先,命名一个ID。
<span id = "jump">跳转到的位置</span>
//然后,建立一个跳转的连接。[说明文字](#jump)
//github上只需执行最后一个步骤。