markdown使用指南

Markdown 语法

现在可以在作业部落的左侧窗口中试试看了。无需注册,直接开始输入文字就好。

要事第一

首先需要注意:在 Markdown 中另起一段时,需要多敲一次回车键,来在段落之间添加一个空行。这是与其他常见文档格式的不同之处。

这是因为,在一些 Markdown 解释器中,会把相邻的两行合并成同一个段落。

例如,当我们这样书写时:

这是第一段。
这是第二段。

实际上看到的效果是这样:

这是第一段。这是第二段。

虽然并非所有 Markdown 解释器都会用同样的解释方式,但是为了避免出错,还是多敲一次回车来添加一个空行吧。

标题

Markdown 中,只需要在文本前面加上“#”,就会被认为是加了一个标题。同理,你还可以增加二级、三级、四级、五级标题和六级标题,只需要增加“#” 即可。例如:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

列表

当你要罗列一些内容时,列表是很有用的工具。为了说明哪些条目属于这个列表,我们需要引入“项目标记”。

列表项目标记通常放在段落开头,后面要跟着一个空格。列表的各个条目之间可以不留空行。

若列表中的条目没有特定顺序时,可以使用 无序列表。加号“+”或减号“-”都可以作为列表标记,后面要跟一个空格。例如:

  • Red

  • Green

  • Blue

或者

  • Red

  • Green

  • Blue

实际显示的效果都是这样的(在不同的环境下显示效果可能会有差异):

  • Red

  • Green

  • Blue

若想在段落前加上数字序号,就需要用到有序列表了。使用数字、一个英文句号和一个空格即可。例如:

1. Red

2. Green

3. Blue

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

  1. Red

  2. Green

  3. Blue

图片

Markdown 中可以插入图片,只需要感叹号、方括号和圆括号即可。例如:

[图片上传失败...(image-7fa733-1509632677704)]

一个英文感叹号 “!” 后紧跟方括号,里面可以写这张图片的说明;再紧跟一对圆括号,里面写这张图片的网址。例如:

[图片上传失败...(image-3c5634-1509632677705)])

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

image

有些 Markdown 编辑器也支持拖拽插入图片,这就简单多了。例如简书 或者 Ulysses 就有这种功能。

链接

在文档中插入连接的语法和插入图片的语法很像,只是少了最前面的英文感叹号"!"。

在方括号写下链接文字,圆括号写下网址即可。例如:

好中文的样子

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

好中文的样子

引用

可以使用">" 标记来引用其他人的言论、书籍或报纸的内容。只需要在段落的第一行最前面加上 > 即可:

”每位作者都应该学习 Markdown。” ——王佩

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

”每位作者都应该学习 Markdown。” ——王佩

引用可以嵌套,只要根据层次的不同,加上不同数量的 > 即可:

这是第一级引用。

这是第二级引用。

现在回到第一级引用。

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

这是第一级引用。

这是第二级引用。

现在回到第一级引用。

在引用的区域内,也可以使用其他的 Markdown 语法,包括标题、列表等:

这是一个标题。

1. 这是第一行列表项。

2. 这是第二行列表项。

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

这是一个标题。

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

强调

在Markdown中,可以使用 * 和 _ 来表示斜体加粗。需要注意的是,“_”是下划线而非减号“-”。

在需要斜体的文本左右各加一个“*”或“_” :

吹吹那热风,听听那冷雨,看哪,好中文的样子。

吹吹那热风,听听那冷雨,看哪,好中文的样子。

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

吹吹那热风,听听那冷雨,看哪,好中文的样子。

吹吹那热风,听听那冷雨,看哪,好中文的样子。

在需要加粗的文本左右各加两个“*”或“_” :

吹吹那热风,听听那冷雨,看哪,好中文的样子。

吹吹那热风,听听那冷雨,看哪,好中文的样子。

实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):

吹吹那热风,听听那冷雨,看哪,好中文的样子。

吹吹那热风,听听那冷雨,看哪,好中文的样子。

分割线

在 Markdown 中,可以用分隔线来将内容分成不同区域。

只需要连续三个减号"-"即可。例如:


实际显示的效果是这样的(在不同的环境下显示效果可能会有差异):


5 常见问题

Q: 我该去哪里下载 Markdown 软件?

A: Markdown 是一种标准而非软件,任何支持 Markdown 语法的编辑器都可以使用,无论是何种操作系统、哪类设备。请看“3 支持 Markdown 的编辑器”,或者问问 Google。


Q:在简书里怎么切换 Markdown?为什么切换了没有反应?

A:建议使用 Chrome 或 Firefox 浏览器。在简书中,点击右上角个人头像-设置,在“常用编辑器”中选中markdown,然后保存。注意一行小字:“切换后对新建文章生效”。然后点击右上角”写新文章“,再点击工具栏右侧倒数第三个按钮“切换到预览模式”,屏幕应该会分成左右两个区域。在左侧区域输入内容、添加标记,右侧就会实时显示 Markdown 效果了。


Q: 为什么我按说明写了标记,但是没法正常显示?

A: 很可能是你误把中文标点当成了英文标点。在 Markdown 中使用标点符号作为标记时,要使用英文标点符号。没关系,人们总会犯这种小错误。


Q: 为什么我写了正确的标记,但是在编辑窗口中看不到任何效果?

A: 许多 Markdown 编辑器都不是所见即所得的——“所见即所得”是指你对格式的修改会马上反映在屏幕上,就像 Word 那样。如果你的编辑器没有没有实时预览功能,就不会看到格式的变化。Macdown简书 都支持实时预览,你需要先打开这个功能,才能看到这些格式标记的效果。


Q: Markdown 可以排版表格吗?

A: 可以,如果你熟练的话,排版表格也会很快。表格的语法请见“Markdown 语法说明(简体中文版)”。


Q: Markdown可以排版数学公式吗?

A: 可以。只要有相应的扩展,Markdown 可以支持LaTeX 公式、甚至画流程图和甘特图。


Q: 标题效果和加粗有区别吗?

A: 看似没有,其实还是有的。这涉及到如何解释 Markdown 标记的问题,一般和 CSS 有关。更多信息,请看“6 扩展阅读”部分。


Q: 加图片时,无 IT 背景人士一般会采用从桌面拖拽的方式。Markdown 支持拖拽吗?

A: 拖拽图片插入文档或上传到网站,不是 Markdown 语法本身的内容。不过有些网站和 Markdown 编辑器支持拖拽方式,例如 Ulysess简书


Q: Markdown 正文可以调整字号吗?

A: 同样和解释 Markdown 标记的方式有关。更多信息,请看“6 扩展阅读”部分。


Q: Markdown 段落开头不能空两格,看着很难受啊。有办法解决吗?

A: 办法嘛……若是在自己机器上的 Markdown 编辑器中,也许你可以修改 CSS。若是在 简书 之类网站上,可能只能手工在每段开始前手工添加五个“&n bsp;”了。记得,是“&nb sp;”,字符和字母之间都没有空格。最后的分号也是有必要的哦~

作者:叶猛犸
链接:http://www.jianshu.com/p/38fe4911b4a0
來源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。</pre>

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

推荐阅读更多精彩内容