Markdown基础学习

Markdown
Markdown是一种可以使用普通文本编辑器编写的标记语言,通过类似HTML的标记语法,它可以使普通文本内容具有一定的格式。
Markdown 是一种轻量级的标记语言,由John Gruber和Aaron Swartz创建。这种语言创建灵感来自于已经存在的带标记的电子邮件文本。Markdown 允许 HTML 语法,所以使用者如果需要可以直接用 HTML来表示是可以的。Markdown最初由Gruber应用在Perl语言中,但它已经有多种编程语言应用了。它是开源项目,并以BSD-style许可证的许可方式以插件形式或内容管理系统形式发布。
Markdown 的目标是实现「易读易写」

Markdown 的优点如下:

纯文本,所以兼容性极强,可以用所有文本编辑器打开。
让你专注于文字而不是排版。
格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。
Markdown 的标记语法有极好的可读性

[标题]

这是最为常用的格式,在平时常用的的文本编辑器中大多是这样实现的:输入文本、选中文本、设置标题格式。
而在 Markdown 中,你只需要在文本前面加上 # 即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加 # 即可,标题字号相应降低。例如:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

注:'#' 和「一级标题」之间建议保留一个字符的空格,这是最标准的 Markdown 写法。

[列表]

列表格式也很常用,在 Markdown 中,你只需要在文字前面加上 - + or * 就可以了,例如:

无序列表

  • 文本1
  • 文本2
  • 文本3

如果你希望有序列表,也可以在文字前面加上 1. 2. 3. 就可以了,例如:

有序列表

  1. 文本1
  2. 文本2
  3. 文本3

注:-、1.和文本之间要保留一个字符的空格。

[链接和图片]

在 Markdown 中,插入链接不需要其他按钮,你只需要使用 显示文本 这样的语法即可,例如:

简书
在 Markdown 中,插入图片不需要其他按钮,你只需要使用

这样的语法即可,例如:

[引用]

在我们写作的时候经常需要引用他人的文字,这个时候引用这个格式就很有必要了,在 Markdown 中,你只需要在你希望引用的文字前面加上 > 就好了,例如:

一盏灯, 一片昏黄; 一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

[粗体和斜体]

Markdown 的粗体和斜体也非常简单,用两个 * 包含一段文本就是粗体的语法,用一个 * 包含一段文本就是斜体的语法。
一盏灯, 一片昏黄;一简书, 一杯淡茶。 其中「一盏灯」是斜体,「一简书」是粗体。

代码引用

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

单行代码引用

hello word

多行代码引用

使用3个反引号

public void main() {
        System.out.println("ok");
}

补充:要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符(tab按键)就可以
所以,对于表格,如果向下面这样书写,有些解释器,就理解为代码而非表格了。
但你只要将表格放到行首,就没有被识别为代码的问题。感觉markdown在细节实现上,各家有些不同。
比如有道就可以识别下面的表格,但简书就要删除前面的4个空格或制表符才可以。

表格

    序号 | 姓名 | 电话号码
    :--- |----- |:-------:
      1  | 王   | 188居中  
序号 姓名 电话号码
1 188居中

注意: 表格至少需要3个-符号才可以,多了貌似无所谓。另外:代表对齐方式。

分割线

分割线的语法只需要另起一行,连续输入三个星号 *** 即可。


复选框

这个有道支持,简书不支持。

  • [x] -
    • [x] -复选框
    • [x] -
  • [ ] -
  • [ ] -

markdown编辑器

win:

  • 有道云笔记,优点,客户端自带markdown模式,左右窗口,实时预览。
  • 简书,优点,在线markdown编辑器,同样实时预览
  • pandoc 通用转换工具,功能强大。

linux:

  • ReText,需要依赖库,麻烦,没有实验。

关于换行

首先,这个问题由来已久。和一般的编辑器习惯不同。
单个回车,视为空格。连续两个回车或者行尾加两个空格,才视为换行。
有道云笔记支持\换行,简书不支持,简书直接替换了换行行为,一个回车即可,符合"一般"编辑器行为。

缩进

Markdown 语言不负责实现段首缩进,段首缩进这件事,应该是 CSS 或者其他排版工具的事情。
Markdown 奉行的是样式和内容分开的哲学。即使手动输入空格, 也是很不推荐的方法。

首行缩进方法:可以在段首加入 来输入一个空格。

vim中编辑

现代的gvim支持markdown语法高亮显示,且斜体和粗体等语法直接就对文字加斜或加粗了。

update:2017.9.4

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

推荐阅读更多精彩内容

  • MarkDown基本语法学习 概述 MarkDown是一种轻量级标记语言,它允许人们使用易读易懂的纯文本格式编写文...
    doMyselfzy阅读 455评论 0 2
  • 为什么学习Markdown 自从搭建了 Hexo 博客之后,发现还有 Markdown 这种写文章的方法,想到以后...
    lifeColder阅读 20,138评论 10 217
  • (Markdown语法没有一个统一的标准,不同的工具或平台采用的标准不一样,所以有些语法规则和功能是有差异的) 0...
    迟道阅读 56,718评论 4 69
  • DAY 1 做了一天的车,路经许多藏家小筑,无形中竟有丝丝感动。抵达观音镇,随着当地人们一同转经,听着经筒发出叮...
    可以种个小蘑菇吗阅读 792评论 2 7
  • 世上总有一片美好的风景使你安静和嚮往,也使你终于知道所有的跋涉都是为了这一刻的幸福。只要活著,就能遇见。
    秋凝浅浅_阅读 185评论 1 4