Markdown语法很简单

本文首发于:https://qinshijia.github.io/2018/08/13/markdown-introduction/

Markdown简介

Markdown是一种轻量级的标记语言,目标是实现易读易写。

简单的语法规则,漂亮的显示效果,容易读写随意改,是Markdown的特点。使用Markdown写作,能让您专注于内容,不需要浪费大量时间去排版。很多博客、在线笔记等工具都支持Markdown格式的文档,例如GitHub、Stack Overflow、简书、为知笔记。

下面会介绍常用的Markdown语法。

Markdown语法

标题

Markdown中标题分为六级,在行首以 # 开头并空一格再写标题文字。# 的个数标题的级数,一级标题字体最大,六级标题字体最小。

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

段落

段落没有标记,段落的前后应该有一个以上空行。段落不推荐使用缩进。

链接

链接标记是一个中括号和一个小括号连在一块,中括号内是要链接的文字,小括号是链接地址,例如这样。链接可以是绝对地址,也可以是相对地址。

[百度](https://www.baidu.com/)

图片

插入图片需要先保存好图片,然后再通过引入图片的方式显示。

图片的标记是一个感叹号、中括号和小括号连在一起,中括号里是图片加载不出来时显示的文字,小括号里是图片的链接地址。

下面这张图片的写法是:

![Markdown图标](https://upload-images.jianshu.io/upload_images/13557430-772d6394ecaf885a.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
Markdown图标

段内代码

段内代码标记是由两个 ` 符号(键盘上制表符上面,1旁边的按键)组成,两个`中间是要显示的代码,例如这样 Hello world!

`Hello world!`

代码块

代码块是在开头和结尾都以三个连续的 ` 符号组成,中间为显示的代码。怎么没有行号?那是Markdown解析后前端显示的问题,不是语法的问题。

String text = "Hello world!";
System.out.print(text);

引用

在段落的开头使用 > 符号即可,显示的效果如下:

这是一段引用

> 这是一段引用

无序序列

无序序列在行开头使用 * 或者 - 或者 + 即可。显示效果如下

  • 无序序列
  • 无序序列
  • 无序序列
* 无序序列
- 无序序列
+ 无序序列

有序序列

有序列表则使用数字接着一个英文句点,数字的大小顺序对显示的结果没有影响,显示结果会按照行的顺序重新编号。

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

表格

表格是用符号 | 标记,在 | 之间的就是表格的内容。第一行是表头,第二行是控制表格显示方式,第三行以后是表格内容。

靠左显示 居中显示 靠右显示
第二行使用符号 :- 第二行使用符号 :-: 第二行使用符号 -:
|靠左显示|居中显示|靠右显示|
|:-|:-:|-:|
|第二行使用符号 :-|第二行使用符号 :-:|第二行使用符号 -:|

强调

强调是在段内的 * 之间插入要强调的文字,一个*是斜体,连续两个 **是加粗,例如 我想倾斜一下我想加粗一下

*我想倾斜一下*
**我想加粗一下**

Markdown工具推荐

Markdown 语法已经足够简单了,使用常用的文本编辑器就能完成写作。随着 Markdown 越来越流行,配套工具也丰富了起来,语法高亮、实时预览、图片粘贴等功能也很吸引人。

这里推荐一款文本编辑器 Atom,它着丰富的插件库,在 Atom 的 File -> settings -> install中搜索相应插件然后安装即可,使用方法在搜索结果界面点进去都有介绍。 Markdown 相关的插件有以下这些:

  • markdown-writer:语法高亮
  • markdown-scroll-sync:编写的时候按了 Ctrl + Shift + M,之后能同步滚动预览
  • markdown-image-assistant:截图之后直接按 Ctrl + V 粘贴

其他工具可以看一下Markdown 在线编辑阅读器及应用收集

参考文档

Markdown 教程

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

推荐阅读更多精彩内容

  • 欢迎关注微信公众号:北岛向南(id:nanzhouie) GitHub Pages:https://zhouie....
    zhouie阅读 4,861评论 4 72
  • 为什么学习Markdown 自从搭建了 Hexo 博客之后,发现还有 Markdown 这种写文章的方法,想到以后...
    lifeColder阅读 20,158评论 10 217
  • Markdown概述 宗旨 Markdown 的目标是实现「易读易写」。Markdown 的特点就是,让写作变得更...
    心疼你萌萌哒阅读 7,728评论 1 24
  • You-Get 使用方法 voQuan关注 2017.02.23 15:38*字数 2600阅读 21425评论 ...
    一瓶百无聊赖阅读 317评论 0 0
  • 一、地球是个偶然,个人是亿万偶然中的偶然。 二、珍惜时间,对宇宙和未来充满敬畏。 三、虫子无法理理解人类的智力级,...
    秦淮书生阅读 1,130评论 0 2