详细介绍MarkDown常用语法

MarkDown

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。

我会以事例和效果的方式来展示,方便大家对照学习。

一、基础语法

1.1 标题

Markdown支持6种级别的标题,对应html标签 h1 ~ h6

# h1
## h2
### h3
#### h4
##### h5
###### h6

效果如下:

h1

h2

h3

h4

h5
h6

1.2 段落及区块引用

段落:
需要记住的是,Markdown其实就是一种易于编写的普通文本,只不过加入了部分渲染文本的标签而已。其最终依然会转换为html标签,因此使用Markdown分段非常简单,前后至少保留一个空行即可。

引用:
我们可能希望对某段文字进行强调处理。Markdown提供了一个特殊符号 > 用于段首进行强调,被强调的文字部分将会高亮显示

>这段文字将被高亮显示...

这段文字将被高亮显示...

1.3 插入链接或图片

插入链接和插入图片的区别只有一个!
[]:链接或图片的描述信息
():链接地址或图片地址

插入链接:

[简书-随风的草稿箱](https://www.jianshu.com/u/5507a8b30a76)

简书-随风的草稿箱

插入图片:

![风景照](https://upload-images.jianshu.io/upload_images/16521770-5a425b5a98c8a9e9.jpeg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
风景照

1.4 列表

Markdown支持有序列表和无序列表
有序列表使用数字加.标识,例如:1. 黄瓜(.与文字之间加上一个空格)

1. 黄瓜
2. 玉米
3. 茄子
  1. 黄瓜
  2. 玉米
  3. 茄子

:这里比较有趣的地方是,对于有序列表,Markdown将只关注你的第一个项目的数字编号。例如:如果第一个项目编号是3,以此类推,第二个项目应该是4,最终将显示为3、4、5。而如果你指定了第一个编号,后面的编号指定错误也没有关系,Markdown将只在乎你的第一个项目编号。

无序列表使用*或+或-标识,后面需要加一个空格

+ 黄瓜
+ 玉米
+ 茄子

- 黄瓜
- 玉米
- 茄子

* 黄瓜
* 玉米
* 茄子
  • 黄瓜
  • 玉米
  • 茄子
  • 黄瓜
  • 玉米
  • 茄子
  • 黄瓜
  • 玉米
  • 茄子

使用列表的一些注意事项

如果在单一列表项中包含了多个段落,为了保证渲染正常,没有*的段落需要缩进4个空格或者一个制表符

* 段落一
    小段落一
* 段落二
  小段落二
  • 段落一
    小段落一
  • 段落二
    小段落二

另外,如果在列表中加入了区块引用,区域引用标记符也需要缩进4个空格或者一个制表符

* 段落一
    > 区块标记一
* 段落二
  > 区块标记二
  • 段落一

    区块标记一

  • 段落二

    区块标记二

总结:记住一个原则,如果在和列表配合使用的时候出现了问题,就缩进一次,四个空格或者一个制表符代表一次缩进。如果一次缩进没有解决问题,那就两次。

1.5 分隔线

有时候,为了排版漂亮,可能会加入分隔线。Markdown加入分隔线非常简单,使用下面任意一种形式都可以

***
---


1.6 强调

对某一部分文字进行强调,使用*或_包裹即可。
使用单一符号标记的效果是斜体,使用两个符号标记的效果是加粗。

*这里是斜体*
_这里是斜体_

**这里是加粗**
__这里是加粗__

这里是斜体
这里是斜体

这里是加粗
这里是加粗

二、高级用法

2.1 插入代码块

Markdown在IT圈子里面比较流行的一个原因是,它能够轻松漂亮地插入代码。方法:使用反引号`进行包裹即可。

如果是行内代码引用,使用单个反引号进行包裹

`var x = 3`

var x = 3

如果插入一整段代码,需要至少使用三个或以上反引号进行包裹,效果如下:

fun (x: Int, y: Int): Int {
  return x + y
}

:很多人不知道怎么输入反引号。在英文模式下,找到键盘最左侧esc键下面的第一个键。

2.2 插入表格

姓名|技能|排行
--|:--:|--:
刘备|哭|大哥
关羽|打|二哥
张飞|骂|三弟
姓名 技能 排行
刘备 大哥
关羽 二哥
张飞 三弟

解释:
第二行分割表头和内容。
-有一个就行,为了对齐,多加了几个
文字默认居左
:加在左边:表示文字局左
:加在右边:表示文字居右
:加在两边:表示文字居中
注:原生的语法两边都要用 | 包起来。此处省略

三、其它

3.1特殊符号处理

Markdown使用反斜杠\来转义用到的特殊符号。在Markdown中,主要有以下几种特殊符号需要处理:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

例如,如果你需要插入反斜杠,就连续输入两个反斜杠即可:\\ => \ 。
注:在内容中输入以上特殊符号的时候一定要注意转义,否则将导致内容显示不全,甚至排版混乱。

3.2 如何给文字上色

Markdown的最初目标就是为纯写作而生的,因此,它并没有考虑文字颜色这一点。
单纯使用Markdown设置文字颜色已经做不到了。但你可以这样做:

  1. 先用Markdown编辑完成
  2. 导出为html,在需要上色的部分手动添加标签<font color='#ff0000'></font>保存即可。

Markdown软件推荐

如果你是一个Mac用户,我推荐你使用开源的MacDown;
一些收费产品其实更好,例如:Byword,Ulysses,Typora等等都很不错。
提供一个在线Markdown编辑器:Cmd Markdown

简单总结

Markdown是一门比html更简单的标记语言,其主要用于日常写作。最终通过相应的编辑器或者脚本转换成html用于页面渲染。

如果你是一个作家,或者是一个程序员,Markdown对你来说是一门必备的技能。掌握Markdown真的很简单,如你所见,这篇文章使用了这么短的篇幅就已经将Markdown的语法全部介绍完了。

不过,由于Markdown基础语法的限制,出现了一些针对Markdown语法的加强版本。它支持的语法特性更多,但这不是我们这篇文章的讨论范围。如果你希望快速掌握Markdown,很简单,动起来吧!

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

推荐阅读更多精彩内容

  • Markdown 语法说明 概述宗旨兼容 HTML特殊字符自动转换 区块元素段落和换行标题区块引用列表代码区块分隔...
    Clunt阅读 834评论 0 4
  • Markdown 语法说明 概述宗旨兼容HTML 区块元素段落和换行标题区块引用列表代码区块表格分割线删除线 区段...
    咚呱阅读 908评论 1 2
  • 文章借鉴于Github 概述 宗旨 Markdown 的目标是实现「易读易写」。对于Markdown来说,可读性性...
    meiqiuyang阅读 433评论 0 1
  • 上课总结:从机器语言(010101010)->汇编语言(add 1,2)有意义的英文单词--->结构化->面向对象...
    程序员有话说阅读 975评论 1 1
  • JavaScript 错误 - throw、try 和 catch try 语句测试代码块的错误。catch 语句...
    BaibaiWang阅读 169评论 0 0