学习使用Markdown

1 关于Markdown

Markdown是一种轻量级标记语言,它的目的是希望大家使用“易于阅读、易于撰写的纯文字格式,并选择性的转换成有效的HTML(或XHTML)”。

  1. 优点

    • 易读

      易读是指Markdown文件(即 .md 文件)容易阅读,与HTML相比,它没有各种繁杂的尖括号<>和缩进。整体简洁美观。

    • 易写

      使用Markdown可以让你专注于文字,不用像office软件一样需要用鼠标疯狂点击那些排版按钮,可以做到手不离键盘且快速高效的将写作与排版一气呵成。而且Markdown语法简单,花半个小时就能学会基本语法。

  2. 缺点

    • 标准不统一

      目前Markdown语法众多、编辑器层出不穷,每个编辑器支持的语法也不同,这就导致在一个编辑器上写的md文件,放到其它编辑器上,出现排版混乱,甚至是不支持某些语法的现象。这就是人们所说的 “方言现象”,这也是目前Markdown最突出的问题。

    • 图片支持不够

      不能直接显示图片,不能调整大小。且不同编辑器对图片的处理也有所不同。

    • 表格支持不够

      原生的Markdown是不支持表格的,但现在大部分编辑器都支持简单的表格,也有支持复杂表格的语法,但是书写困难,且不被大多数编辑器支持。

    • 占用特殊字符

      Markdown的语法占用了一些特殊字符,导致想在文本中输入特殊字符的时候,需要进行转义操作。

  3. 使用群体

    • 喜欢写博客的人
    • 经常阅读书写各种技术文档的技术人员
    • 混迹于各种技术论坛和社区的程序员
    • 追求简洁排版、快速编辑的文字工作者

2 基本语法

2.1 标题

只需要在文本前面加上 # 号即可(注意#号后面有一个空格),二级标题加两个 ## ,三级标题加三个 ### ,以此类推,最多六级标题。

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

2.2 列表

1. 无序列表

使用 *,+,- 表示无序列表。列表可以嵌套,上一级和下一级之间敲三个空格即可,建议相同级别的列表项使用相同的符号,并且保持缩进一致,如一级列表用 *,二级列表用 +,三级列表用 -(注意后面需要加空格)

示例:

* 无序列表项1
   + 无序列表项1.1
      - 无序列表项1.1.1
   + 无序列表项1.2
      - 无序列表项1.2.1
* 无序列表项2
* 无序列表项3

效果如下:

  • 无序列表项1
    • 无序列表项1.1
      • 无序列表项1.1.1
    • 无序列表项1.2
      • 无序列表项1.2.1
  • 无序列表项2
  • 无序列表项3

2. 有序列表

使用数字和点表示有序列表。(注意后面需要加空格)

示例:

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

效果如下:

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

2.3 字体

*斜体*
**加粗**
***斜体加粗***
~~删除线~~

效果如下:

  • 斜体
  • 加粗
  • 斜体加粗
  • 删除线

2.4 引用

在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>>,貌似可以一直嵌套下去。

> 引用
>> 引用
>>> 引用
>>>>>>>> 引用

效果如下:

引用

引用

引用

引用

2.5 分割线

使用三个或三个以上的 -*
示例:

---
--------
***
********

效果如下:


2.6 超链接

加入超链接的格式如下:

[链接名字](链接地址, "链接title")

其中链接title可以不填。
例如:

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

注意:不能直接写成 www.baidu.com ,需要加 https://或http://

效果如下,点击即可访问:
百度一下

2.7 插入图片

插入图片的格式如下:

![图片描述](图片地址)

其中图片title可以不填。
例如:

![tree](http://hru.com/blog/180910/84.jpg?imageim)

效果如下:


tree

2.8 表格

下面是一般表格的书写格式:

表头|表头|表头
---|---|---
内容|内容|内容
内容|内容|内容

表的两边可以加 | 将表包围起来,也可以不加,效果一样,如下所示:

|表头|表头|表头|
|---|---|---|
|内容|内容|内容|
|内容|内容|内容|

Markdown默认表的内容是左对齐,标题是居中对齐,我们可以根据需要,使用 : 来进行对齐。
示例:

左对齐|居中|右对齐
:---|:---:|---:
内容|内容|内容
内容|内容|内容

"-"短线每一栏加1个就够了,这里为了对齐,都加了3个。
左边加":"表示文字居左。
两边加":"表示文字居中。
右边加":"表示文字居右。

效果如下:

左对齐标题 居中标题 右对齐标题
内容 内容 内容
内容 内容 内容

2.9 代码

Markdown可以内嵌代码,还支持代码高亮,不同开发语言有不同的高亮形式。

语法如下:

单行代码使用两个 ` 将代码包围起来:

> `代码`

多行代码使用两个 ``` 加代码语言标识:

> (``` 语言标识)
> 代码块
> (```)

上面的括号和>不用写,这里为了方便展示多加了,请忽略

语言标识是对各种语言的分类,如:python,c,bash,java,php,sql......

效果如下:

单行代码: unsigned int a;

多行代码(语言标识:C):

int main()
{
  int a = 9;
  printf("%d\n", a);
  return 0;
}

2.10 待办事宜 Todo 列表

使用带有 [ ] 或 [x] (未完成或已完成)项的列表语法撰写一个待办事宜列表,并且支持子列表嵌套以及混用Markdown语法,例如:

- [ ] 一级任务
    - [ ] 二级任务
    - [x] 二级任务
    - [x] 二级任务
        - [x] 三级任务
        - [x] 三级任务
- [ ] 一级任务
    - [ ] 二级任务

效果如下:

  • [ ] 一级任务
    • [ ] 二级任务
    • [x] 二级任务
    • [x] 二级任务
      • [x] 三级任务
      • [x] 三级任务
  • [ ] 一级任务
    • [ ] 二级任务

3、支持Markdown语法的软件或网站

编辑软件:

  1. atom —— 21世纪黑客文本编辑器,里面有各种插件,程序猿专用软件,也是我目前在用的编辑软件。
  2. Visual Studio Code —— 一心想要统治地球的软件,对Markdown语法要求严格,经常会出现红波浪线和绿波浪线。
  3. MarkdownPad —— 一款全功能的编辑器,被很多人称赞为windows 平台最好用的markdown编辑器。
  4. Sublime Text 2 —— 界面简约大方,定位专业。
  5. Smark
  6. MdCharm

网站(在线编辑器):

  1. 简书 —— 一个很好的博客平台,简约美观,写文章时可以直接拖入图片生成链接。
  2. dillinger —— 支持md, html, pdf 文件导出。支持dropbox, onedrive,google drive, github.
  3. Cmd Markdown
  4. 小书匠编辑器

如果上面没有适合你的编辑器,请自行上网查找其它的编辑器。


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

推荐阅读更多精彩内容