标题
Markdown支出两种标题的语法。
一、在标题的底部紧跟着=
和 -
,任何数量的 =
和 -
都可以有效果。
例如:
这是一个H1的标题
=============
这是一个H2的标题
------------------
效果:
这是一个H1的标
这是一个H2的标题
二、 在文字开头插入 1 到 6 个 #
,对应到标题 1 到 6 阶,为了美观,你可以在行尾加上 #
,标题 1 到 6 阶取决于开头的#
数量,而行尾的 #
数量也不用和开头一样,效果都是一样的。
例如:
(方法一)
# 这是H1的标题
## 这是H2的标题
###### 这是H6的标题
(方法二)
# 这是H1的标题 #
## 这是H2的标题 ##
###### 这是H6的标题 ######
效果:
这是H1的标题
这是H2的标题
这是H6的标题
代码区块
我一直很喜欢一句话,Talk is cheap. Show me the code,所以说一篇技术性文章缺少不了代码区块,Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以。一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。注意:在代码区块中,一般的 Markdown 语法不会被转换,eg:*
就只是*
而已。
例如:
这是一行普普通通的文字。
这是一个代码区块 * 1
这是末尾行
效果:
这是一行普普通通的文字。
这是一个代码区块 * 1
这是末尾行
分割线
一行中使用3个以上的*
、-
、_
来建立一个分隔线,行内不能有其他东西。但是可以*
、-
、_
中间插入空格。
例如:
***
****
* * *
---
----
- - -
___
____
_ _ _
效果:
(为了美观。只取其中一条的效果)
区块引用
一、在每行的最前面加上 >
即可。
例如:
> 这是一个区块引用
效果:
这是一个区块引用
二、 如果你觉得在整个段落的每行最前面加上>
,数量太多的时候,Markdown允许你只在整个段落的第一行前面加上>
。
例如:
> 这是第一行
这是第二行
这是最后一行
效果:
这是第一行
这是第二行
这是最后一行
三、区块引用可以使用多层嵌套(例如:引用内的引用),只要根据层次加上不同数量的 >
。
例如:
> 这是第一行
> > 这是第二行
> > > 这是第三行
>
> 这是最后一行
效果:
这是第一行
这是第二行
这是第三行
这是最后一行
-
引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块、链接等:
例如:> ## 这是一个标题。 > > 1. 这是第一行列表项。 > 3. 这是第二行列表项。 > > 给出一些例子代码: > [简书](https://www.jianshu.com) > extension UIColor{}
效果:
这是一个标题。
- 这是第一行列表项。
- 这是第二行列表项。
给出一些例子代码:
简书
extension UIColor{}
列表
项目列表,Markdown 支持有序列表和无序列表。
一、 无序列表使用*
、+
、-
作为列表标记,效果都是一样的,Markdown 会让输出的列表数字按用户输入的输出。
例如:
(写法一)
* 方法一
* 方法二
* 方法三
(写法二)
+ 方法一
+ 方法二
+ 方法三
(写法三)
- 方法一
- 方法二
- 方法三
效果:
- 方法一 (用的是*)
- 方法二(用的是+)
- 方法三 (用的是-)
二、有序列表则使用数字接着一个英文句点,你可以完全不用在意前面数字的正确性,输出的列表数字,Markdown 会按照当前段位的起始列表数字依次递增。
例如:
(任意随机数)
20. 方法一 (起始20)
1. 方法二
8. 方法三
效果:
- 方法一 (起始20)
- 方法二
- 方法三
三、 列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符。为了code工整,建议每行缩进,看起来会看好很多,如果你没有这样子做,Markdown也会在输出的时候帮您实现缩进的。
例如:
* 我就是我,不一样的烟火。
我喜欢看动漫,eg:火影、海贼、妖精的尾巴等等,
* 我也喜欢打王者,可是很菜。
效果:
-
我就是我,不一样的烟火。
我喜欢看动漫,eg:火影、海贼、妖精的尾巴等等,
-
我也喜欢打王者,可是很菜。
四、如果要在列表项目内放进引用,那 >
就需要缩进。
例如:
* 这是一个带区块引用的列表项目
> 这是一个区块引用
> 它被包含在列表里项目里面.
效果:
-
这是一个带区块引用的列表项目
这是一个区块引用
它被包含在列表里项目里面.
五、 如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:
例如:
* 一列表项包含一个列表区块:
<我是代码区块>
效果:
-
一列表项包含一个列表区块:
<我是代码区块>
六、异常数据处理
例如:
项目列表很可能会不小心产生,像是下面这样的写法:
2018. 4 月 12 日,天气晴。
效果:
- 4 月 12 日,天气晴。
换句话说,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上\
。
例如:
2018\. 4 月 12 日,天气晴。
效果:
2018. 4 月 12 日,天气晴。
代码
一、如果要标记一小段行内代码,你可以用`
把它包起来就行。
例如:
`这是一段代码`
效果:
这是一段代码
二、如果要在代码区段内插入`
,你可以在代码片段的起始跟末端分别插入两个`
反引号。
例如:
``这行里面有个(`)符号哟。``
效果:
这行里面有个(`)符号哟。
三、代码区段的起始和结束端都可以放入一个空白,起始端后面一个,结束端前面一个,这样你就可以在区段的一开始就插入```:
例如:
这一行里面有个特殊的字:`` `龘` ``,不知道你们会不会读哦。
效果:
这一行里面有个特殊的字:`龘`
,不知道你们会不会读哦。
强调
Markdown 使用*
和_
作为标记强调字词的符号。
一、文字前后紧跟着相同的*
或者_
,使得文字有了简单的强调效果。
例如:
*Markdown*
_简书_
效果:
Markdown
简书
二、文字前后紧跟着相同的两个*
或_
,使得文字有了strong的强调效果。
例如:
**Markdown**
__简书__
效果:
Markdown
简书
三、你可以随便用你喜欢的样式,唯一的限制是,你用什么符号开启标签,就要用什么符号结束,一行可以使用多个强调。
(注意:一段文字中,前后两个强调文字不要连续使用同一种符号,防止错误的识别)
例如:
这是*小小在流浪*在_简书_上发布__一篇__关于**Markdown**的文章。
效果:
这是小小在流浪在简书上发布一篇关于Markdown的文章。
四、如果文字前后的*
和_
两边都有空白的话,它们就只会被当成普通的符号。
例如:
这是* 小小在流浪*在简书上__ 发布 __一篇关于Markdown的文章。
效果:
这是* 小小在流浪*在简书上__发布 __一篇关于Markdown的文章。
五、如果要在文字前后直接插入普通的*
或*
,你可以在强调符号前面插入\
:
例如:
这是\*小小在流浪\*在简书上 发布一篇\__关于\__Markdown的文章。
效果:
这是*小小在流浪*在简书上 发布一篇__关于__Markdown的文章。
链接
Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。
不管是哪一种,链接文字都是用[]
来标记。
一、行内式的链接:只要在[]
后面紧接着()
并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用""
把 title 文字包起来即可。
例如:
这是小小在流浪在[简书](https://www.jianshu.com/u/3a19789f1337 "可选标题")的文章。
效果:
这是小小在流浪在简书的文章。
二、如果你是要链接到同样主机的资源,你可以使用相对路径。
例如:
点击[下载](/apps/)简书App。
效果:
点击下载简书App。
三、参考式链接:在[]
里面加入用以辨识链接的标记文字或者ID即可。
例如:
这是小小在流浪在[简书]的文章。
接着,把这个标记的链接内容定义出来。
链接内容定义的格式为:
[标记]: 网址 "可选标题"
链接内容定义:
[简书]: https://www.jianshu.com "可选标题"
效果:
这是小小在流浪在简书的文章。
四、如果[]
里面用以辨识链接的标记文字过于长的话,我们可以用另一个简短的标记进行替代,只需要在[]
的后面再接着一个[]
,然后在第二个 []
写入替代的标记。
例如:
这是小小在流浪在[简书][replaceId]的地址。
[replaceId]:https://www.jianshu.com/u/3a19789f1337
效果:
这是小小在流浪在简书的地址。
图片
Markdown 支持两种形式的图片语法: 行内式和参考式两种形式。
一、行内式格式:
![文字][图片路径]
例如:
![乔巴](https://img.haomeiwen.com/i5902884/4a0f7a0e8658bda3.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
效果:
乔巴二、参考式格式:
![文字][标记]
[标记]: 网址 "可选标题"
例如:
![路飞][Luffy]
[Luffy]: https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1523862255354&di=25ba1fe05978d577bd5c6c85e01d92e8&imgtype=0&src=http%3A%2F%2Fimg.m.club.pchome.net%2Fupload%2Fclub%2Fother%2F2008%2F8%2F9%2Fsmall%2Fpics_xcmjwxj_1218277987.jpg "海贼王"
效果:
路飞脚注
格式:[^标记]
例如:
这是一个链接到简书的脚注[^脚注]。
[^脚注]: https://www.jianshu.com
效果:
这是一个链接到简书的脚注[1]。
反斜杠
如果只想在Markdowm中插入普通的符号,只需要在插入的符号前面
插入\
即可。
例如:
\\
\&
\*简书\*
效果:
\
&
*简书*
自动链接
格式:[网址]
例如:
这是一个自动链接<https://www.jianshu.com>
效果:
这是一个自动链接https://www.jianshu.com
网友评论