markdown 易学易用(So easy!)

Markdown 是一种轻量级标记语言,创始人为 John Gruber 。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML (或者 HTML )文档”。

1 标题

标题共六级,一级标题字号最大,字号随着级别的增加递减。leanote 最多支持五级标题,简书可支持六级。

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

显示效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2 列表

2.1 无序列表

无序列表项前的标记符号可以使用*+-,标记符号后须加至少一个空格

+ 无序列表项1
- 无序列表项2
* 无序列表项3

显示效果如下:

  • 无序列表项1
  • 无序列表项2
  • 无序列表项3

2.2 有序列表

有序列表项前加上数字和一个英文句号,英文句号后须加至少一个空格。数字的大小排序不影响最终显示的效果。

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

显示效果如下:

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

注:leanote 的 markdown 编辑器,无序和有序列表前还需要添加一个空行,简书不需要。

3 注脚

在需要加注的文字后加上[^note],即可加上注脚,具体语法如下所示。注意,这里的脚注1, note2 和 footnote3 可以换成其他文字,只要前后保持一致即可。

使用 Markdown[^脚注1]可以效率地书写文档,直接转换成 HTML[^note2],你可以使用 Leanote[^footnote3] 编辑器进行书写。

(注:leanote 的 markdown 编辑器,以下各个注脚解释之间还需要用一个空行分隔,简书不需要)

[^脚注1]:Markdown 是一种纯文本标记语言

[^note2]:HyperText Markup Language 超文本标记语言

[^footnote3]:开源笔记平台,支持 Markdown 和笔记直接发为博文

显示效果如下:

使用 Markdown[1]可以效率地书写文档,直接转换成 HTML[2],你可以使用 Leanote[3] 编辑器进行书写。

4 插入链接

链接可指定 title 属性,也可省略。如定义了 title 属性,当鼠标悬停在链接文字上时会显示 title 属性的值。

[链接文字](链接地址 "title")

例如:[简书](//www.greatytc.com/  "简书官网")

显示效果如下:

简书

<>将链接包围起来,即自动转换成链接。

<http://example.com/>
<address@example.com>

显示效果如下:

http://example.com/
address@example.com

5 插入图片

插入图片的语法为:![](图片链接 图片title)

  • 图片 alt 是当图片无法显示时,替代图片的文字信息,可省略。
  • 图片 title 是当鼠标悬停在图片上时显示的文字,可省略。
![宋民咕 鱼香肉丝里面没有肉](http://upload-images.jianshu.io/upload_images/4558002-00c60a9b78e694da.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "宋民咕")

显示效果如下:

宋民咕 鱼香肉丝里面没有肉

6 区块引用

引用文本时,在文本前加>即可,> 与引用文本之间需保留一个空格。

> 假如生活欺骗了你
> 不要悲伤,不要心急
> 忧郁的日子里需要镇静
> 相信吧,快乐的日子将会来临
> 心儿永远向往着未来
> 现在却常是忧郁
> 一切都是瞬息,一切都将会过去
> 而那过去了的,就会成为亲切的怀恋

显示效果如下:

假如生活欺骗了你
不要悲伤,不要心急
忧郁的日子里需要镇静
相信吧,快乐的日子将会来临
心儿永远向往着未来
现在却常是忧郁
一切都是瞬息,一切都将会过去
而那过去了的,就会成为亲切的怀恋

区块引用可以嵌套(引用内的引用),还可以在引用内使用其他的 markdown 语法,例如:

> 宋代欧阳修则云:
> 最佳读书时间,乃为三上:即**枕上**、**马上**、**厕上**。
> —— *刘真《论读书》*

显示效果如下:

宋代欧阳修则云:
最佳读书时间,乃为三上:即枕上马上厕上
—— 刘真《论读书》

7 粗体、斜体、加粗斜体和删除线

具体语法如下:

1. **粗体**
2. *斜体*
3. ***加粗斜体***
4. ~~删除线~~

显示效果如下:

  1. 粗体
  2. 斜体
  3. 加粗斜体
  4. 删除线

8 输入代码

8.1 输入单行代码

输入单行代码的语法:`单行代码`。显示效果如下:

var a = 1

8.2 输入多行代码

输入多行代码的语法如下,在第一行的 ``` 后面加上代码语言,leanote 和简书都能实现语法高亮。
在每行代码前输入四个或四个以上的空格也能实现代码块的效果。

```python
class Employee:
empCount = 0

def init(self, name, salary):
self.name = name
self.salary = salary
Employee.empCount += 1
```

显示效果如下:

class Employee:
   empCount = 0
   def __init__(self, name, salary):
        self.name = name
        self.salary = salary
        Employee.empCount += 1

9 表格

表格第一行为表头,第二行分隔表头与表格主体部分,第三行开始为表格主体部分。
列与列之间以|分隔。
第二行还可为不同列指定对齐方式,|:------:|为居中对齐,|------:|为右对齐,|:------|为左对齐。

|table |table   |table  |
|:-----|:------:|------:|
|1     |2       |3      |
|4     |5       |6      |

显示效果如下:

table table table
1 2 3
4 5 6

10 分隔线

输入三个以上的*-_即可生成分隔线,*-_之间可插入空格。

***

---

___

显示效果如下:




11 定义

如果需要对某个名词的定义作出解释,可以选用以下语法格式,目前简书不支持这个功能,leanote 支持。

名词 1
:    定义 1(左侧有一个冒号和四个空格)

leanote 上的显示效果如下:

12 Html 标签

leanote 支持在 Markdown 语法中嵌套 Html 标签,简书不支持。譬如,你可以用 Html 写一个纵跨两行的表格:

<table>
    <tr>
        <th rowspan="2">值班人员</th>
        <th>星期一</th>
        <th>星期二</th>
        <th>星期三</th>
    </tr>
    <tr>
        <td>李强</td>
        <td>张明</td>
        <td>王平</td>
    </tr>
</table>

leanote 上的显示效果如下:

也可以通过 img 标签插入图片,利用 img 标签的 height 和 width 属性来设置图片的高度和宽度。

![](http://upload-images.jianshu.io/upload_images/4558002-73942e9b78c2b21e.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

leanote 上的显示效果如下:

13 目录

通过 [TOC] 在文档中插入目录,简书暂不支持。leanote 上的显示效果如下:

14 其他

想更多地了解和学习 markdown,可参阅以下资料:


  1. Markdown 是一种纯文本标记语言

  2. HyperText Markup Language 超文本标记语言

  3. 开源笔记平台,支持 Markdown 和笔记直接发为博文

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

推荐阅读更多精彩内容

  • 1. 斜体和粗体 代码: 显示效果: 这是一段斜体 这是一段粗体 这是一段加粗斜体 这是一段删除线 2. 分级标题...
    泊牧阅读 2,342评论 0 2
  • 为什么学习Markdown 自从搭建了 Hexo 博客之后,发现还有 Markdown 这种写文章的方法,想到以后...
    lifeColder阅读 20,158评论 10 217
  • 上课总结:从机器语言(010101010)->汇编语言(add 1,2)有意义的英文单词--->结构化->面向对象...
    程序员有话说阅读 986评论 1 1
  • 蕙质兰心,晓情达理。 孝负终身,良人未及。 恬退隐忍,抑郁成疾。 韶华已去,空留...
    兰雪清风阅读 293评论 0 1
  • 老爸的病现在是我一心头病,虽跟其他亲人常一同讨论,但其实内心的想法又是无处诉说,不得不写下来以解心忧,也让心理方面...
    梵芃阅读 147评论 0 0