Markdown 新手指南

概述

认识 Markdown

Markdown 是一种用来写作的轻量级【标记语言】,它通过使用一些符号组成的标记来实现像 Word 那样的排版。Markdown 的目的是实现【易读易写】,无论如何, 可读性,是最重要的。

Markdown 的优点

  • 让我们专注于内容,而不是排版样式。
  • 纯文本带来的超强的兼容性, 所有文本编辑器都能打开。
  • 格式转换方便,能攻轻松地转换为 pdf,html 等。
  • 语法简单,学习成本低。

Markdown 的误区

We believe that writing is about content, about what you want to say – not about fancy formatting. 我们坚信写作写得是内容,所思所想,而不是花样格式。-Ulysses for Mac

语法

特殊符号

Markdown 是通过精挑细选的一些符号来实现内容的排版的, 主要使用了:

\\ 反斜线           -- 用来转义,来实现符号插入
 \` 反引号           -- Esc下方那个键,用于标记代码
\* 星号             -- 用于定义无序列表
_ 底线             -- 用来定义二级标题
= 等号             -- 用来定义一级标题 
{} 花括号          -- 
[] 方括号          -- 
() 括弧            -- 
\# 井号             -- 用来定义标题
\+ 加号             -- 用来定义无序列表
\- 减号             -- 用来定义无序列表
\. 英文句号         -- 通过和数字组合定义有序列表
\! 感叹号           -- 用来区分引入的是网址还是图片
\> 尖括号           --用来定义引用区块

我们可以通过反斜杠来插入普通的符号,也可以通过反斜杠来插入一些语法中有其他意义的符号。例如用 * 号加在文字旁边的方式来做出强调

区块元素

标题

这是最常用的格式,Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。 类 Setext 形式是用底线的形式, 利用 "=" (最高阶标题)和 "-"(第二阶标题),例如:

This is H1
======
This is H1
===
This is H1
==
This is H2
--------
This is H2
---
This is H2
--
Setext 格式的标题

可以使用数量大于2个的 "=" 和 "-" 来实现一介标题和二阶标题。
类 Atx 形式则是在行首插入 1-6 个 "#",对应标题 1-6 阶,例如

#         This is H1
##        This is H2
###       This is H3
####      This is H4
#####     This is H5
######    This is H6
Atx 格式的标题

你可以像这样选择性的闭合类 Atx 样式的标题。

区块引用

Markdown 标记区块引用用的是 ">" 来引用,例如这样:

> 你的孤独,虽败犹荣。也许你现在仍然是一个人下班,一个人乘地铁,一个人上楼,一个人吃饭,一个人睡觉,一个人发呆。然而你却能一个人下班,一个人乘地铁,一个人上楼,一个人吃饭,一个人睡觉,一个人发呆。很多人离开另外一个人,就没有自己。而你却一个人,度过了所有。

引用示例一

你也可以这样:

> 你的孤独,虽败犹荣。 也许你现在仍然是一个人下班, 一个人乘地铁,一个人上楼,一个人吃饭,一个人睡觉,一个人发呆。
> 然而你却能一个人下班,一个人乘地铁,一个人上楼,一个人吃饭,一个人睡觉,一个人发呆。 
> 很多人离开另外一个人,就没有自己。 而你却一个人,度过了所有。
引用示例二

你还可以这样:

> 你的孤独,虽败犹荣。
> 
> > 也许你现在仍然是一个人下班,一个人乘地铁,一个人上楼,一个人吃饭,一个人睡觉,一个人发呆。
> > 
> > 然而你却能一个人下班,一个人乘地铁,一个人上楼,一个人吃饭,一个人睡觉,一个人发呆。很多人离开另外一个人,就没有自己。
> 
> 而你却一个人,度过了所有。

引用示例三

当然,还能这样:

> #### 你的孤独,虽败犹荣。
> 
> *   也许你现在仍然是一个人下班,一个人乘地铁,一个人上楼,一个人吃饭,一个人睡觉,一个人发呆。
> 
> 1.  然而你却能一个人下班,一个人乘地铁,一个人上楼,一个人吃饭,一个人睡觉,一个人发呆。很多人离开另外一个人,就没有自己。
> 
> + 而你却一个人,度过了所有。

引用示例四

列表

Markdown 支持有序列表和无序列表。
无序列表通过 "*", "+", "-" 作为标记符号,例如:

* 1Red
* 1Green
* 1Blue

+ 2Red
+ 2Green
+ 2Blue

- 3Red
- 3Green
- 3Blud

无序列表

有序列表则使用数字连接英文句号,例如:

1. 1Red
2. 1Green
3. 1Blue


211. 2Red
10. 2Green
54. 2Blue

有序列表

很重要的一点是,不论你在列表上使用的数字为几都不影响 HTML 输出。

代码区块

和程序相关的写作,通常会有已经排版好的代码区块,我们不希望代码也和文章一样去排版,而是希望它按照原来的样子显示,那么我们就希望用 Markdown 建立代码区块。

Markdown 建立代码区块很简单,你可以简单的缩进 4 个空格或者 1 个制表符,例如:

这是一个普通段落
   这是一个代码段落 4 个空格
这是一个普通段落
 这是一个代码段落 1 个制表符
代码区块

建立代码区块的 4 个方法中,4 个空格和一个制表符代码区块会一直持续到没有缩进的那一行或者文件结尾。

分隔线

我们可以在一行中通过三个以上的 ''*', "-", "_" 来建立一个分隔线,行内不能有除了空格以外的东西,下面是三种不同的写法建立的分隔线:

分隔线1
* * *
分隔线2
***
分隔线3
**********
分隔线4
- - -
分隔线5

---
分隔线6

----------
分隔线7
_ _ _
分隔线8
___
分隔线9
__________

分隔线

分隔线要注意的是减号分隔线需要和上面一行间隔一行,不然会把上面那行定义为二阶标题。

区段元素

链接

Markdown 支持两种形式的链接语法:行内式和参考式。通过 "[]" 方括号来标记。行内式链接只需要在方括号后面加入圆括号并插入网址即可,如果还想加入链接的 title 文字,只需要在圆括号中在链接地址后加入一个空格再加入"" 把 title 文字包起来即可,例如:

这是[百度](http://www.baidu.com "网络1")。
这是[本地资源](/1.html "本地1")。
行内式链接

参考式链接是在链接文字的方括号之后再接一个方括号,第二个方括号里面放的是链接的标记,我们只要在文件中的任意位置把标记定义出来就可以了,例如:

这是[百度][baidu]。
这是[本地资源][bendi]。
[baidu]:http://www.baidu.com "网络1"
[bendi]:/1.html (本地1)
参考式链接

我们可以看得出来,无论是标记在何处定义,标记都是有效的,并且我们定义标记的时候定义的 title 可以采取双引号,圆括号 两种形式。
**请注意: ** Markdown.p1 1.0.1 会忽略单引号包起来的链接 title,所以我介绍的时候没有介绍单引号。

隐式链接标记功能可以让我们省去定义链接标记,例如:

这是[Google][]
[Google]:http://www.google.com
隐式链接

图片

Markdown 插入图片采取的是和链接很相似的语法来标记图片的,同样也是允许两种样式:行内式和参考式。都是在链接的前面添加一个 "!" 标识即可,存在 "!" 标识的为图片,不存在的为链接,例如:

这是本地行内图片1 ![图片1](/image/1.jpg "图片1")

这是网络行内图片2 ![图片1](http://blog.qiji.tech/wp-content/uploads/2016/01/12-e1453187944177-64x64.jpg "图片2")

[tupian3]: /image/1.jpg "图片3"
这是本地参考图片3 ![图片3][tupian3]

这是网络参考图片4 ![图片4][tupian4]
[tupian4]: http://blog.qiji.tech/wp-content/uploads/2016/01/12-e1453187944177-64x64.jpg "图片4"

图片链接

我们写博文的时候经常要用到图片;推荐:事先通过我们博客的多媒体把图片上传到我们博客,到时候在文章中通过图片标签把链接加上即可;也可以直接使用我们编辑博文的编辑器上方的 “Add Media” 来添加图片。另外图片的命名需要注意,最好是图片所代表的意义,可为拼音可为英文,别直接用QQ截图xxxx的。我们上传的图片生成的链接是有规律的,如果没有命名重复的,一个批次上传的链接只有文件名不同,其他的都是一致的。

强调

Markdown 使用 "" 号和 "_" 来作为标记强调字词的符号,被一个 "" 或者一个 "" 包起来的字词会变成斜体,被两个 "*" 或者两个 "" 包起来的字词会被加粗,例如:

*斜体*
_斜体_
**粗体**
__粗体__
斜体和粗体

代码

如果要在行内添加代码,我们可以用\ 把代码包起来`,例如:。

我要输出代码:`alert(ab);`。

我要输出代码:``alert(a`b);``。

行内代码

注意: 三个 "```" 可以形成代码区块,标准Markdown 是不支持的,GFM 才支持
注意:我们的博客暂时不支持行内添加代码标签的使用。

本地撰写工具

Windows

  • markdownpad2
  • HarooPad

Mac

  • Byword
  • Mou
  • MacDown
  • Typora

Linux

  • ReText

本文转载自 Markdown 新手指南,如有冒犯,侵权,即删。

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

推荐阅读更多精彩内容