Markdown快速入门

如果你追求极简,恨不得直接用记事本来写文章,那么Markdown将会是你的得力工具。因为它简单,优雅,只需几个标记,就能使你的文章排版显得自然美观。文章洋洋洒洒,一气呵成,预览所见即所得,排版简洁大方。

花几分钟学会Markdown,绝对让你受益终生。

Markdown是什么

Markdown是一种文本标记语言,它通过在文本中增加简单标记,实现文本的格式化。利用Markdown,你可以轻松的实现分段、分级标题、插入链接,插入图片、插入视频等功能。github、Stackoverflow、简书等网站均支持Markdown格式。Markdown的目标是易读易写。保存的文件名后缀为‘.md’.

Markdown语法

Markdown的语法本来就非常简单,但是有些功能实现方式有多种,为了更加简洁,本文只取其中最直观,好理解,便于记忆的一种。毕竟写文章不需要知道“回”字的四种写法。

标题

标题使用#号来表示,请注意#号和标题之间有一个空格。类似的Markdown标记与文本之间一般都会有个空格。

# 一级标题
## 二级标题
### 三级标题

这段语法效果如下:

一级标题

二级标题

三级标题

按照这个规律标题可以分为很多级,建议在文章中使用不超过三级标题。

段落与换行

如果你需要分段,只需要在段与段之间留有空白行:

古之学者必有师。师者,所以传道受业解惑也。人非生而知之者,孰能无惑?惑而不从师,其为惑也,终不解矣。生乎吾前,其闻道也固先乎吾,吾从而师之;生乎吾后,其闻道也亦先乎吾,吾从而师之。吾师道也,夫庸知其年之先后生于吾乎?是故无贵无贱,无长无少,道之所存,师之所存也。

嗟乎!师道之不传也久矣!欲人之无惑也难矣!古之圣人,其出人也远矣,犹且从师而问焉;今之众人,其下圣人也亦远矣,而耻学于师。是故圣益圣,愚益愚。圣人之所以为圣,愚人之所以为愚,其皆出于此乎?爱其子,择师而教之;于其身也,则耻师焉,惑矣。彼童子之师,授之书而习其句读者,非吾所谓传其道解其惑者也。句读之不知,惑之不解,或师焉,或不焉,小学而大遗,吾未见其明也。巫医乐师百工之人,不耻相师。士大夫之族,曰师曰弟子云者,则群聚而笑之。问之,则曰:“彼与彼年相若也,道相似也。位卑则足羞,官盛则近谀。”呜呼!师道之不复,可知矣。巫医乐师百工之人,君子不齿,今其智乃反不能及,其可怪也欤!

如果是想在同一个段落里另起一行,则只需要在第二行末尾空两格:

第一行      //此处末尾两次空格键盘后回车,即space space enter
第二行

这段语法效果如下:

古之学者必有师。师者,所以传道受业解惑也。人非生而知之者,孰能无惑?惑而不从师,其为惑也,终不解矣。生乎吾前,其闻道也固先乎吾,吾从而师之;生乎吾后,其闻道也亦先乎吾,吾从而师之。吾师道也,夫庸知其年之先后生于吾乎?是故无贵无贱,无长无少,道之所存,师之所存也。

嗟乎!师道之不传也久矣!欲人之无惑也难矣!古之圣人,其出人也远矣,犹且从师而问焉;今之众人,其下圣人也亦远矣,而耻学于师。是故圣益圣,愚益愚。圣人之所以为圣,愚人之所以为愚,其皆出于此乎?爱其子,择师而教之;于其身也,则耻师焉,惑矣。彼童子之师,授之书而习其句读者,非吾所谓传其道解其惑者也。句读之不知,惑之不解,或师焉,或不焉,小学而大遗,吾未见其明也。巫医乐师百工之人,不耻相师。士大夫之族,曰师曰弟子云者,则群聚而笑之。问之,则曰:“彼与彼年相若也,道相似也。位卑则足羞,官盛则近谀。”呜呼!师道之不复,可知矣。巫医乐师百工之人,君子不齿,今其智乃反不能及,其可怪也欤!

换行效果如下:
第一行
第二行

区块引用

使用>标记引用:

> 那一年我二十一岁,在我一生的黄金时代,我有好多奢望。
> 我想爱,想吃,还想在一瞬间变成天上半明半暗的云。

这段语法效果如下:

那一年我二十一岁,在我一生的黄金时代,我有好多奢望。
我想爱,想吃,还想在一瞬间变成天上半明半暗的云。

列表与表格

列表可分为有序列表和无序列表:


1. 有序列表
2. 有序列表
3. 有序列表

- 无序列表
- 无序列表
- 无序列表

表格语法:

    |  姓名     |      年龄      |  身高 |
    |----------|:-------------:|------:|
    | 司徒乔    |  33           | 177   |
    | 欧阳易    |    63         |   166 |
    | 百求具    | 55            |   188 |

上面的语法效果如下:

  1. 有序列表
  2. 有序列表
  3. 有序列表
  • 无序列表
  • 无序列表
  • 无序列表

表格语法:

姓名 年龄 身高
司徒乔 33 177
欧阳易 63 166
百求具 55 188

代码区块

代码区块连续的三个英文反引号来标记:

   ```
   package main
   
   import "fmt"

   func main() {
    
       fmt.Printf("Hello, world.\n")
   
   }
   ```

这段语法效果如下:

package main
 
import "fmt"
 
func main() {

    fmt.Printf("Hello, world.\n")

}

行内代码

行内代码则使用一个英文反引号标记:

求和函数`func sum()`

效果如下:

求和函数func sum()

特殊字符

有些特殊符号可以通过实体名称或实体编号来表示:

版权实体名称:© 
版权实体编号:©
注册商标实体名称:®
注册商标实体编号:®

有些字符本来就是Markdown的语法载体,可以使用反斜杠转义:

    \*标记的内容\*

    \# 有井号,但这不是标题

效果如下:

版权符号实体名称:©
版权符号实体编号:©
注册商标实体名称:®
注册商标实体编号:®

*标记的内容*

# 有井号,这不是标题

分隔线

分隔线语法三个连续的-

---

分隔线效果:


粗体与斜体

粗体使用**包围,斜体使用*包围:

**粗体**

*斜体*

效果如下:

粗体

斜体

链接

插入链接的语法:

 这是[6m](https://6m.cx/)的链接。

效果是这样的:

这是6m的链接。

图片

想要文章图文并茂?和插入链接类似,注意前面的'!':

![GitHub Cat](https://github.com/fluidicon.png)

图片效果如下:

GitHub Cat

Markdown 编辑器

市面上Markdown编辑器多如牛毛,这里介绍几个免费的:

Windows 平台

Linux 平台

Mac 平台

结语

Markdown语法就是这么简单。快去使用Markdown写作练练手吧,熟练以后,你就会忘掉语法,彷佛文章本来就该这么写。

参考链接

Markdown语法说明

Markdown.tw

版权申明

转载自:天边风
作者:天边风
原文链接:[https://www.tbfeng.com/learn-markdown-in-three-minutes.html
)

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

推荐阅读更多精彩内容

  • 引言 觉得自己有必要要学学Markdown了,但同时担心光看自己记不住,同时想作为工具书日后忘记用于回顾。本文删去...
    谢随安阅读 318评论 0 0
  • 刚接触Markdown,总结一些常用语法,希望能帮助一些像我一样的初学者快速入门。 一、段落前面的空格 输入法切换...
    sunnygarden阅读 921评论 0 1
  • 段落、标题、区块代码 一个段落是由一个以上的连接的行句组成,而一个以上的空行则会划分出不同的段落(空行的定义是显示...
    garyond阅读 190评论 0 2
  • Markdown 1. 兼容HTML Markdown语法的目标是:成为一种适用于网络的书写语言。Markdown...
    晴天sy阅读 215评论 0 0
  • 写在开始之前 什么是Markdown Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多...
    Dyeed阅读 837评论 9 22