Markdown基本语法


一、Markdown简介

Markdown是一种轻量级的标记语言,创始人为约翰·格鲁伯(英语:John Gruber)。约翰·格鲁伯于2004年创造了Markdown语言,有相当大一部分语法是和亚伦·斯沃茨(Aaron Swartz)合作完成。

二、Markdown的优点

语法简单易学,常用的标记符号不超过十个,兼容所有的文本编辑器与字处理软件,可以导出 为HTML、PDF 和本身的 .md 文件。Markdown目前在很多网站被广泛使用,例如简书

三、Markdown 基本语法总结

在简书中将默认编辑器设置为MarkDown编辑器,切换为预览模式就可以边输入边看到呈现效果了。

  • 标题

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

一级标题

二级标题

this is an H1

This ia a H2

在MarkDown编辑器中的写法为:
一级标题
================
二级标题
-------------
This is a H1
================
This is a H2
---------------

(任何数量的 `=` 和 `-` 都可以有效果。)

类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如:

H1 一级标题

H2二级标题

H3 三级标题

H4四级标题

H5五级标题
H6六级标题
在MarkDown编辑器中的写法为:
#H1 一级标题
##H2二级标题
###H3 三级标题
####H4四级标题
#####H5五级标题
######H6六级标题

  • 插入图片:![]()

例如:[图片上传失败...(image-7149c3-1525536139655)]

在MarkDown编辑器中的写法为:
例如:![](https://zh.wikipedia.org/static/images/project-logos/zhwiki.png).

  • 插入链接:[链接文字](链接地址)

例如: Markdown

在MarkDown编辑器中的写法为:
例如: [Markdown](http://zh.wikipedia.com/wiki/Markdown)

  • 引用

    引用只需在被引内容段落开头加上右尖括号>即可。可以选择只在开头加一个或在每行前面都加一个,效果是一样的。
    引用可以嵌套。如果要在一个引用里插入一个引用,可以用两个>开头。依此类推,根据嵌套层次加相应数量的符号。

这是第一个引用。

这是一个嵌套引用。这是第二层引用的第一行。
这是第二行

外层引用的第三行。空行前面的>可有可没有。


  • 列表

列表格式常用的有无序列表和有序列表两种,在 Markdown 中,只需在文字前面加上 星号、加号或是减号作为列表标记就可以表示无序列表,而 类似1.xxxxxx 前面直接使用数字接着一个英文句点则表示有序列表。例如:

无序列表
  • content 1
  • content 2
  • content 3
  • content 4
有序列表
  1. content 1
  2. content 2
  3. content 3
  4. content 4
上述列表格式在MarkDown编辑器中的写法为:
######无序列表
- content 1    
- content 2
- content 3
- content 4
######有序列表
1. content 1    
2. content 2
3. content 3
4. content 4

  • 文字修饰(强调符号 * *, _ _)

强调强调
加重强调意味

在MarkDown编辑器中的写法为:*强调* ,_强调_  (预览表现为斜体;**加重强调意味**预览表现为黑体加粗。)

  • 分隔符

要生成水平分隔线,可以在单独一行里输入3个或以上的短横线、星号或者下划线实现。短横线和星号之间可以输入任意空格。以下每一行都产生一条分隔线。





the first content


the second content

以上分割线在MarkDown编辑器中的写法为:
* * *                上方第一条分隔线
***                  上方第二条分隔线
- - -                上方第三条分隔线
------------------   上方第四条分隔线
the first content

------------------------------
the second content
(!第一部分结束部分若为文字需先换行,空一行再添加一行分隔符)
  • 换行

在文本中输入的换行会从最终生成的结果中删除,浏览器会根据可用空间自动换行。如果想强迫换行,可以在行尾插入至少两个空格。


  • 行内代码引用

需要引用代码时,如果引用的语句只有一段,不分行,可以用 ` 将语句包起来。
如果引用的语句为多行,可以将```置于这段代码的首行和末行。

例如:![]()

在MarkDown编辑器中的写法为:
例如:[图片上传失败...(image-da8196-1525536139655)].

本文多次使用了行内代码引用

  • 表格

id name sex
001 Jeny girl
002 Lilei boy
003 charry girl
在MarkDown编辑器中的写法为:
id | name | sex
----|------|----
001 | Jeny  | girl
002 | Lilei  | boy
003 | charry  | girl

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

推荐阅读更多精彩内容

  • 前言 初学markdown,看了一些指南,第一次在简书上用markdown做的一个总结,大部分为摘抄与精简,主要是...
    Yolanda__WU阅读 940评论 0 0
  • atom编辑器的使用和markdown基本语法 atom介绍 atom是什么 Atom是github内部的编辑软件...
    Haoqian阅读 35,441评论 3 39
  • 1. 标题 Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。 类 Setext 形式是...
    Eva3288阅读 394评论 0 0
  • Markdown 是一种轻量级标记语言,能将文本换成有效的XHTML(或者HTML)文档,它的目标是实现易读易写,...
    萌萌的wo阅读 350评论 0 0
  • #标题1##标题2###3级标题一级标题===一级标题========二级标题---<&©<####段落引用> T...
    oking阅读 2,068评论 0 1