Markdown入门

标题

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允许你只在整个段落的第一行前面加上>
例如:

> 这是第一行
  这是第二行
  这是最后一行

效果:

这是第一行
这是第二行
这是最后一行

三、区块引用可以使用多层嵌套(例如:引用内的引用),只要根据层次加上不同数量的 >
例如:

>  这是第一行
> > 这是第二行
> > > 这是第三行
>
> 这是最后一行

效果:

这是第一行

这是第二行

这是第三行

这是最后一行

  1. 引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块、链接等:
    例如:

    > ## 这是一个标题。
    >
    > 1.   这是第一行列表项。
    > 3.   这是第二行列表项。
    > 
    > 给出一些例子代码:
    > [简书](https://www.jianshu.com)
    >    extension UIColor{}
    

效果:

这是一个标题。

  1. 这是第一行列表项。
  2. 这是第二行列表项。

给出一些例子代码:
简书
extension UIColor{}


列表

项目列表,Markdown 支持有序列表和无序列表。
一、 无序列表使用*+-作为列表标记,效果都是一样的,Markdown 会让输出的列表数字按用户输入的输出。
例如:

 (写法一)
*   方法一
*   方法二    
*   方法三
(写法二)
+   方法一
+   方法二
+   方法三
(写法三)
-   方法一
-   方法二
-   方法三

效果:

  • 方法一 (用的是*)
  • 方法二(用的是+)
  • 方法三 (用的是-)

二、有序列表则使用数字接着一个英文句点,你可以完全不用在意前面数字的正确性,输出的列表数字,Markdown 会按照当前段位的起始列表数字依次递增。
例如:

(任意随机数)
20.  方法一 (起始20)
1.  方法二
8.  方法三

效果:

  1. 方法一 (起始20)
  2. 方法二
  3. 方法三

三、 列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符。为了code工整,建议每行缩进,看起来会看好很多,如果你没有这样子做,Markdown也会在输出的时候帮您实现缩进的。
例如:

*  我就是我,不一样的烟火。

    我喜欢看动漫,eg:火影、海贼、妖精的尾巴等等,

*  我也喜欢打王者,可是很菜。

效果:

  • 我就是我,不一样的烟火。

    我喜欢看动漫,eg:火影、海贼、妖精的尾巴等等,

  • 我也喜欢打王者,可是很菜。

四、如果要在列表项目内放进引用,那 >就需要缩进。
例如:

*   这是一个带区块引用的列表项目

    > 这是一个区块引用
    > 它被包含在列表里项目里面.

效果:

  • 这是一个带区块引用的列表项目

    这是一个区块引用
    它被包含在列表里项目里面.

五、 如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:
例如:

* 一列表项包含一个列表区块:

        <我是代码区块>

效果:

  • 一列表项包含一个列表区块:

      <我是代码区块>
    

六、异常数据处理
例如:
项目列表很可能会不小心产生,像是下面这样的写法:

2018. 4 月 12 日,天气晴。

效果:

  1. 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 支持两种形式的图片语法: 行内式和参考式两种形式。
一、行内式格式:

![文字][图片路径]

例如:

![乔巴](http://upload-images.jianshu.io/upload_images/5902884-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


  1. https://www.jianshu.com

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,470评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,393评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,577评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,176评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,189评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,155评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,041评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,903评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,319评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,539评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,703评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,417评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,013评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,664评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,818评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,711评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,601评论 2 353

推荐阅读更多精彩内容

  • Markdown 语法手册 概述宗旨兼容HTML特殊字符子自动转换 区块元素段落和换行标题区块引用列表代码区块列表...
    Junting阅读 531评论 0 0
  • 最近写博客对makedown的语法有些生疏,今天写一个markdown入门博客来熟悉下markdown的语法和适用...
    Chris__Liu阅读 326评论 0 0
  • [toc] ## MarkDown 是什么?   想了很久,第二篇文章写什么好呢。这篇文章既要让大家感兴趣,又要让...
    黄盼_b024阅读 572评论 0 3
  • 前言## 既然是入门学习,那还是要稳扎稳打,根据简书官方给出的献给写作者的 Markdown 新手指南和Markd...
    Oliver_Le阅读 1,055评论 4 4
  • 是不是每个人都有自己的特点 独特却没有味道 让人头疼 自以为自己可以重新接受一份想当然的爱情 可是自己做不到对每个...
    JadeZu阅读 306评论 0 0