markdown的使用

标题

Markdown 中,只需要在文本前面加上“#”,就会被认为是加了一个标题。同理,你还可以增加二级、三级、四级、五级标题和六级标题,只需要增加“#” 即可。例如:

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

显示效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

段落

换行

在markdown中,直接换行是没用的,比如:


所有的结局都已写好
所有的泪水也都启程

写好的格式是这样,但是有时会显示成


所有的结局都已写好所有的泪水也都启程

也就是一排显示,这时只需要在俩行中间敲一下enter,即可换行,但是此时俩行中间间距略微偏多,这时可以在第一行末尾,敲俩个空格,也可实现效果。

缩进

在markdown中缩进:

  • 半方大的空白 或 
  • 全方大的空白 或 
  • 不断行的空白格 或 

列表

当你要罗列一些内容时,列表是很有用的工具。为了说明哪些条目属于这个列表,我们需要引入“项目标记”。

列表项目标记通常放在段落开头,后面要跟着一个空格。列表的各个条目之间可以不留空行。

无序列表

若列表中的条目没有特定顺序时,可以使用 无序列表。加号“+”或减号“-”都可以作为列表标记,后面要跟一个空格。例如:

+ 苹果

+ 橘子

+ 梨子

或者:

- 苹果

- 橘子

- 梨子

显示效果:

  • 苹果

  • 橘子

  • 梨子

有序列表

若想在段落前加上数字序号,就需要用到有序列表了。使用数字、一个英文句号和一个空格即可。例如:

1. 苹果

2. 橘子

3. 梨子

显示效果:

  1. 苹果

  2. 橘子

  3. 梨子

多级列表

图片

Markdown 中可以插入图片,只需要感叹号、方括号和圆括号即可。例如:

![text](Picture address)

一个英文感叹号 “!” 后紧跟方括号,里面可以写这张图片的说明;再紧跟一对圆括号,里面写这张图片的网址。例如:

![一只可爱的狗狗](https://upload-images.jianshu.io/upload_images/12865607-9d166ae9050e9f8e.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

显示效果:

一只可爱的狗狗

当然,如果你只是想单纯上传一张图片,不想有文字描述,把文字去掉就可以了:

![](https://upload-images.jianshu.io/upload_images/12865607-9d166ae9050e9f8e.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

显示效果:


链接

在文档中插入连接的语法和插入图片的语法很像,只是少了最前面的英文感叹号"!"。

在方括号写下链接文字,圆括号写下网址即可。

外部链接

[这是简书的首页](https://www.jianshu.com/)

显示效果:

这是简书的首页

内部链接1

链接到仓库中(github)的其他文件:
[demo1](demo1.md)

显示效果:

demo1
点击的话会跳转到demo1.md文件

内部链接2

链接到本文档的其他部分(类似于html的锚点)

[代码块 demo](demo2.md#代码块-demo)

效果:
代码块 demo

引用式链接

这个链接就是在文档某处(一般是文档尾部),定义好,用的地方直接使用:
<!--下面是本文档中可能用到的链接-->
[简书]:https://www.jianshu.com

使用时,直接书写 “[百度]” 即可实现链接效果


强调

在Markdown中,可以使用 * 和 _ 来表示斜体和加粗。需要注意的是,“_”是下划线而非减号“-”。

斜体

在需要斜体的文本左右各加一个“*”或“_” ,例如:

*所谓美好的心灵,就是能体贴万物的心,能温柔对待一草一木的心灵。*
_所谓美好的心灵,就是能体贴万物的心,能温柔对待一草一木的心灵。_

显示效果:

所谓美好的心灵,就是能体贴万物的心,能温柔对待一草一木的心灵。

加粗

在需要加粗的文本左右各加两个“*”或“_” ,例如:

**所谓美好的心灵,就是能体贴万物的心,能温柔对待一草一木的心灵。**
__所谓美好的心灵,就是能体贴万物的心,能温柔对待一草一木的心灵。__

显示效果:

所谓美好的心灵,就是能体贴万物的心,能温柔对待一草一木的心灵。

斜体并加粗

在需要斜体并加粗的文本左右各加三个“*”或“_” ,例如:

***所谓美好的心灵,就是能体贴万物的心,能温柔对待一草一木的心灵。***
___所谓美好的心灵,就是能体贴万物的心,能温柔对待一草一木的心灵。___

显示效果:

所谓美好的心灵,就是能体贴万物的心,能温柔对待一草一木的心灵。

删除线

在文字俩旁各加2个 “~” 即可实现删除线的效果:

~~¥199.00~~

显示效果:

¥199.00


引用

可以使用">" 标记来引用其他人的言论、书籍或报纸的内容。只需要在段落的第一行最前面加上 > 即可,例如:

> 青春不是玫瑰,青春是伏特加酒,看起来不怎么样,喝光的时候,才知道它的后劲满强。 —— 林清玄 《你心柔软,却有力量》

显示效果:

青春不是玫瑰,青春是伏特加酒,看起来不怎么样,喝光的时候,才知道它的后劲满强。 ——林清玄 《你心柔软,却有力量》

在引用的区域内,也可以使用其他的 Markdown 语法,包括标题、列表等,例如:

> *青春不是玫瑰,青春是伏特加酒,看起来不怎么样,喝光的时候,才知道它的后劲满强。* ——林清玄 《你心柔软,却有力量》

显示效果:

青春不是玫瑰,青春是伏特加酒,看起来不怎么样,喝光的时候,才知道它的后劲满强。 ——林清玄 《你心柔软,却有力量》


分割线

在 Markdown 中,可以用分隔线来将内容分成不同区域。
这里有三种写法,三个“-”、三个“*”、三个“_”,都可实现分割线的效果:

  • ---
  • ***
  • ___

显示效果都是:


简书中编辑代码

在markdown中编辑代码段,分为块式代码和行内代码

块式代码

可以切换英文输入法,开头和结尾各打三个 “ ``` ”,即可,例如:

```
let add = ( ...val )=>{ // 不定参数求和
var result = 0;
for( var i = 0; i < val.length; i++ ){
result += val[i];
}
return result;
}
console.log( add( 100, 200 ) ); // 300
```

显示效果:

let add = ( ...val )=>{     // 不定参数求和
    let result = 0;
    for( let i = 0; i < val.length; i++ ){
        result += val[i];
    }
    return result;
}
console.log( add( 100, 200 ) );     // 300
行内代码

代码的开头和结尾各打一个 "`" 即可:

我们如果要在浏览器中弹出信息,可以使用`alert( " hello " )`。

效果:

我们如果要在浏览器中弹出信息,可以使用alert( " hello " )

表格

表格有时是挺有用的,这里讲解一下,一个基础的表格实现方式:

| 姓名 | 年龄 | 性别 |
| ----- | ----- | ----- |
| tom | 23 | 男 |
| jack | 18 | 男 |
| alice | 22 | 女 |

效果:

姓名 年龄 性别
tom 23
jack 18
alice 22

这里可以定义表格的对齐方式,分别是居左对齐(默认)、居中对齐、居右对齐,实现方式就是:

| 姓名 | 年龄 | 性别 |
| :----- | :-----: | -----: |
| tom | 23 | 男 |
| jack | 18 | 男 |
| alice | 22 | 女 |

也就是在不同的位置加冒号,效果:

姓名 年龄 性别
tom 23
jack 18
alice 22

表情

经测试,github是支持添加emoji表情的,输入不同的符号码(俩个冒号包围的字符),可以显示出不同的表情,比如笑脸:
:smile:
以下是部分表情:


复杂场景的实现

图片链接

一张图片链接到百度
[![](https://www.baidu.com/img/bd_logo1.png)](https://www.baidu.com)
效果:

混合强调样式
  • ***加粗倾斜***
  • **~~加粗删除~~**
  • ***~~加粗倾斜删除~~***

效果:

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

推荐阅读更多精彩内容

  • 1、定义: Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(英语:John Gruber)。它允许人...
    零一_fb4d阅读 508评论 0 0
  • 非原创,只是为了方便学习,原文地址https://www.jianshu.com/p/q81RER 标题 这是最为...
    yzbkaka阅读 196评论 0 0
  • 写文的时候弄不清用法,看看下右上设置里的语法参也不是很明白,便自己学习了下,下面是总结,建议收藏。 图片发自简书A...
    林露如雨阅读 997评论 6 10
  • Markdown 是什么 Markdown 是一种轻量级标记语言,创始人为 John Gruber。它允许人们“使...
    onizuka_jp阅读 418评论 0 0
  • 1.怎么用标题 只需要在文本前面加上#即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总...
    淡然7698阅读 419评论 0 1