1. Markdown是什么?

Markdown是一种轻量级标记语言,它以纯文本形式(易读、易写、易更改)编写文档,并最终以HTML格式发布。

Markdown也可以理解为将以MARKDOWN语法编写的语言转换成HTML内容的工具。

2. 谁创造了它?

它由Aaron Swartz和John Gruber共同设计,Aaron Swartz是一位有着开挂一般人生经历的程序员。维基百科对他的介绍是:软件工程师、作家、政治组织者、互联网活动家、维基百科人。

他有着足以让你跪拜的人生经历:

· 14岁参与RSS 1.0规格标准的制订。
· 2004年入读斯坦福,之后退学。
· 2005年创建Infogami,之后与Reddit合并成为其合伙人。
· 2010年创立求进会(Demand Progress),积极参与禁止网络盗版法案(SOPA)活动,最终该提案被撤回。
· 2011年7月19日,因被控从MIT和JSTOR下载480万篇学术论文并以免费形式上传于网络被捕。
· 2013年1月自杀身亡。

天才都有早逝的归途。

3. 为什么要使用它?

· 它是易读(看起来舒服)、易写(语法简单)、易更改纯文本。处处体现着极简主义的影子。
· 兼容HTML,可以转换为HTML格式发布。
· 跨平台使用。
· 越来越多的网站支持Markdown。
· 更方便清晰地组织你的电子邮件。(Markdown-here, Airmail)
· 摆脱Word(我不是认真的)。

4. 谁在用?

Markdown的使用者:
· GitHub
· 简书
· Stack Overflow
· Apollo
· Moodle
· Reddit
· 等等

5. 尝试一下

5.1 斜体和粗体

*斜体*或_斜体_
**粗体**
***加粗斜体***
~~删除线~~
实际效果:

斜体或_斜体_

粗体

加粗斜体

删除线

5.2 分级标题

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
实际效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

5.3 超链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式,行内式一般使用较多。

5.3.1 行内式

语法说明:
[]里写链接文字,()里写链接地址, ()中的”“中可以为链接指定title属性,title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字。链接地址与链接标题前有一个空格。
欢迎来到[KINGWDY's blog](https://kwblog.netlify.app)
欢迎来到[KINGWDY's blog](https://kwblog.netlify.app "liyang's blog")
实际效果

欢迎来到KINGWDY's blog

欢迎来到KINGWDY's blog

5.3.2 参考式

参考式超链接一般用在学术论文上面,或者另一种情况,如果某一个链接在文章中多处使用,那么使用引用 的方式创建链接将非常好,它可以让你对链接进行统一的管理。
语法说明:
参考式链接分为两部分,文中的写法 [链接文字][链接标记],在文本的任意位置添加[链接标记]:链接地址 “链接标题”,链接地址与链接标题前有一个空格。
如果链接文字本身可以做为链接标记,你也可以写成[链接文字][]
[链接文字]:链接地址的形式,见代码的最后一行。
我经常去的几个网站[Google][1],[YouTube][2],[YouTube][]。

[1]:http://www.google.com
[2]:https://www.youtube.com "YouTube"
[YouTube]:https://www.youtube.com
实际效果:

我经常去的几个网站Google,YouTube,YouTube

5.3.3 自动链接

语法说明:
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用<>包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:
<http://example.com/>
<address@example.com>
实际效果

http://example.com/

address@example.com

6.锚点

网页中,锚点其实就是页内超链接,也就是链接本文档内部的某些元素,实现当前页面中的跳转。比如我这里写下一个锚点,点击回到目录,就能跳转到目录。 在目录中点击这一节,就能跳过来。还有下一节的注脚。这些根本上都是用锚点来实现的。

注意:

1.Markdown Extra 只支持在标题后插入锚点,其它地方无效。
2.Leanote 编辑器右侧显示效果区域暂时不支持锚点跳转,所以点来点去发现没有跳转不必惊慌,但是你发布成笔记或博文后是支持跳转的。
实际效果:

这个有点问题,会跳转到新标签页的页尾,因为hexo会在生成的a标签上加上target="_blank"这个属性,暂时无法解决。

7.列表

7.1 无序列表

使用 *,+,- 表示无序列表。
- 无序列表项 一
- 无序列表项 二
- 无序列表项 三
实际效果:
  • 无序列表项 一
  • 无序列表项 二
  • 无序列表项 三

7.2 有序列表

有序列表则使用数字接着一个英文句点。
1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三
实际效果
  1. 有序列表项 一
  2. 有序列表项 二
  3. 有序列表项 三

7.3 定义型列表

语法说明:

定义型列表由名词和解释组成。一行写上定义,紧跟一行写上解释。解释的写法:紧跟一个缩进(Tab)
代码块 1 Markdown
: 轻量级文本标记语言,可以转换成html,pdf等格式(左侧有一个可见的冒号和四个不可见的空格) 代码块 2
: 这是代码块的定义(左侧有一个可见的冒号和四个不可见的空格) 代码块(左侧有八个不可见的空格)
实际效果:
代码块 1 Markdown

轻量级文本标记语言,可以转换成html,pdf等格式(左侧有一个可见的冒号和四个不可见的空格)

代码块 2

这是代码块的定义(左侧有一个可见的冒号和四个不可见的空格)

  代码块(左侧有八个不可见的空格)

7.4 列表缩进

语法说明:

列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。
*   轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!
* 那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。
但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!
悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。
实际效果:
  • 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。

    那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。

    软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!
  • 那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。

    寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。

    但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!

    悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。

7.5 包含段落的列表

语法说明:

列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符(显示效果与代码一致):
*   轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。
那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。
软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草! 那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。
但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥! * 悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。
实际效果:
  • 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。

    那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。

    软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!

    那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。

    寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。

    但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!

  • 悄悄的我走了, 正如我悄悄的来; 我挥一挥衣袖, 不带走一片云彩。

7.6 包含引用的列表

语法说明:

如果要在列表项目内放进引用,那 > 就需要缩进:
*   阅读的方法:
> 打开书本。
> 打开电灯。
实际效果
  • 阅读的方法:

    打开书本。

    打开电灯。

7.7 包含代码区块的引用

语法说明:

如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符

7.8 一个特殊情况

在特殊情况下,项目列表很可能会不小心产生,像是下面这样的写法:
1986. What a great season.
会显示成:
    1. What a great season.
换句话说,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠:
1986\. What a great season.

这样就正常显示了:

  • 1986. What a great season.

8.引用

语法说明:

引用需要在被引用的文本前加上>符号。
> 这是一个有两段文字的引用,
无意义的占行文字1.
无意义的占行文字2. > 无意义的占行文字3.
无意义的占行文字4.
实际效果:

这是一个有两段文字的引用,

无意义的占行文字1.

无意义的占行文字2.

无意义的占行文字3.

无意义的占行文字4.

8.1 引用的多层嵌套

区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > :
>>> 请问 Markdwon 怎么用? - 小白

>> 自己看教程! - 愤青

> 教程在哪? - 小白
实际效果:

请问 Markdwon 怎么用? - 小白

自己看教程! - 愤青

教程在哪? - 小白

8.2 引用其它要素

引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:
> 1.   这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码:
>
> return shell_exec("echo $input | $markdown_script");
实际效果:
  1. 这是第一行列表项。
  2. 这是第二行列表项。

给出一些例子代码:

return shell_exec("echo $input | $markdown_script");

9.插入图像

图片的创建方式与超链接相似,而且和超链接一样也有两种写法,行内式和参考式写法。
语法中图片Alt的意思是如果图片因为某些原因不能显示,就用定义的图片Alt文字来代替图片。 图片Title则和链接中的Title一样,表示鼠标悬停与图片上时出现的文字。 Alt 和 Title 都不是必须的,可以省略,但建议写上。

9.1 行内式

语法说明:![图片Alt](图片地址 “图片Title”)

美丽风景:
![美丽风景](https://yuhongjun.github.io/assets/media/scenery.jpeg "美丽风景")
实际效果:

美丽风景:

9.2 参考式

语法说明:

在文档要插入图片的地方写![图片Alt][标记]
在文档的最后写上[标记]:图片地址 “Title”
![美丽风景](https://yuhongjun.github.io/assets/media/scenery.jpeg "美丽风景")
[scenery]:https://yuhongjun.github.io/assets/media/scenery.jpeg "美丽风景"
实际效果:



[scenery]:https://yuhongjun.github.io/assets/media/scenery.jpeg "美丽风景"

10.内容目录

在段落中填写
目录
效果参见最上方的目录

11.注脚

语法说明:

在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。 然后在文本的任意位置(一般在最后)添加脚注,脚注前必须有对应的脚注名字。
注意:经测试注脚与注脚之间必须空一行,不然会失效。成功后会发现,即使你没有把注脚写在文末,经Markdown转换后,也会自动归类到文章的最后。
使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Leanote[^Le] 编辑器进行书写。

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

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

[^Le]:开源笔记平台,支持Markdown和笔记直接发为博文
实际效果:

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

注:脚注自动被搬运到最后面,请到文章末尾查看,并且脚注后方的链接可以直接跳转回到加注的地方。

12.LaTeX公式

12.1 $表示行内公式:

质能守恒方程可以用一个很简洁的方程式 $E=mc^2$ 来表达。
实际效果:

质能守恒方程可以用一个很简洁的方程式 $E=mc^2$ 来表达。

12.2 $$ 表示整行公式:

$$\sum_{i=1}^n a_i=0$$
$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$
$$\sum^{j-1}_{k=0}{\widehat{\gamma}_{kj} z_k}$$

访问 MathJax 参考更多使用方法。

13.表格

语法说明:

不管是哪种方式,第一行为表头,第二行分隔表头和主体部分,第三行开始每一行为一个表格行。
列于列之间用管道符|隔开。原生方式的表格每一行的两边也要有管道符。
第二行还可以为不同的列指定对齐方向。默认为左对齐,在-右边加上:就右对齐。

13.1 简单方式写表格:

学号|姓名|分数
-|-|-
小明|男|75
小红|女|79
小陆|男|92
实际效果:
学号 姓名 分数
小明 75
小红 79

13.2 原生方式写表格:

|学号|姓名|分数|
|-|-|-|
|小明|男|75|
|小红|女|79|
|小陆|男|92|
实际效果:
学号 姓名 分数
小明 75
小红 79
小陆 92

13.3 为表格第二列指定方向:

产品|价格
-|-:
Leanote 高级账号|60元/年
Leanote 超级账号|120元/年
实际效果:
产品 价格
Leanote 高级账号 60元/年
Leanote 超级账号 120元/年

14.分割线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
* * *

***

*****

- - -

---------------------------------------
显示效果都是一样的。

15.代码

对于程序员来说这个功能是必不可少的,插入程序代码的方式有两种,一种是利用缩进(Tab), 另一种是利用”`”符号(一般在ESC键下方)包裹代码。

语法说明:

插入行内代码,即插入一个单词或者一句代码的情况,使用code这样的形式插入。
插入多行代码,可以使用缩进或者“code “,具体看示例。

注意: 缩进式插入前方必须有空行

15.1 行内式

C语言里的函数 `scanf()` 怎么使用?
实际效果:

C语言里的函数 scanf() 怎么使用?

15.2 缩进式多行代码

缩进 4 个空格或是 1 个制表符
一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。
    #include <stdio.h>
int main(void)
{
printf("Hello world");
}
#include <stdio.h>
int main(void)
{
printf("Hello world");
}

15.3 用六个`包裹多行代码

` ` `
#include <stdio.h>
int main(void)
{
printf("Hello world");
}
` ` `
另外说明一下,第一个 ```后可以加上代码的类型,js代码就加上js,css就加上css,渲染出来的样式会有区别。比如下面这段,虽然内容基本差不多,第一个是js,第二个是json,渲染出来就是不一样的。如果不加的话文字都是白色的。
var object ={
"avatar": "http://image.luokangyuan.com/1_qq_27922023.jpg",
"name": "码酱",
"introduction": "我不是大佬,只是在追寻大佬的脚步",
}
{
"avatar": "http://image.luokangyuan.com/1_qq_27922023.jpg",
"name": "码酱",
"introduction": "我不是大佬,只是在追寻大佬的脚步"
}
var object ={
"avatar": "http://image.luokangyuan.com/1_qq_27922023.jpg",
"name": "码酱",
"introduction": "我不是大佬,只是在追寻大佬的脚步",
}

15.4 HTML 原始码

在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码,只需要复制贴上,剩下的 Markdown 都会帮你处理,例如:

第一个例子:

<div class="footer">
2018 ***
</div>
实际效果:
2022 ***

END

感谢观看,可以的话请我吃呗咖啡吧~~~


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

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

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

Markdown使用指南的更多相关文章

  1. Markdown使用指南(1)——基础语法

    [TOC] Markdown使用指南 标题 # 这是一级标题 ## 这是二级标题 ### 这是三级标题 ###### 这是六级标题 引用 > 这是一级引用 >> 这是二级引用 > ...

  2. MarkDown入门指南

    标题 标题是每篇文章必备而且最常用的格式. 在Markdown中,如果想将一段文字定义为标题,只需要在这段文字前面加上 #,再在 # 后加一个空格即可.还可增加二.三.四.五.六级标题,总共六级,只需 ...

  3. Markdown语法指南

    1.背景 个人比较喜欢用Markdonw写东西,比如写博客随笔,写有道云笔记等,但有的时候会突然忘记某个具体语法怎么写了,如插入图片.插入链接.表格等,那干脆把这个语法简单地总结一下,也方便日后快速查 ...

  4. [转载]Markdown——入门指南

    http://www.jianshu.com/p/1e402922ee32/ 转载请注明原作者,如果你觉得这篇文章对你有帮助或启发,也可以来请我喝咖啡. 导语: Markdown 是一种轻量级的「标记 ...

  5. Markdown 完全指南

    概述 Markdown 是一种用于网络文本书写的轻量级标记语言,广泛用于个人 blog.github.wiki 中.其实浏览器并不能识别 Markdown 的语法,但许多 blog.wiki 平台以及 ...

  6. Markdown入门指南-指间阁

    宗旨 Markdown 的目标是实现「易读易写」. 可读性,无论如何,都是最重要的.一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成. ...

  7. Markdown——入门指南

    导语: Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用.看到这里请不要被「标记」.「语言」所迷惑,Markdown 的语法十分简单.常用的标记 ...

  8. markdown 语法指南

    说明:左边是markdown的语法 右边是预览.(我这里用了黑色的背景,一般白色较多) 1. 标题 2.列表 3.引用 (1)一层引用 (2)多层引用 4.图片(如果是本地:按照语法写图片路径:如果是 ...

  9. Markdown 入门指南

    导语: Markdown是一种轻量级的标记语言,语法简单,学习成本不算太高,但确实可以让你专注于文字,不用太分心与排版等等. Markdown 官方文档 这里可以看到官方的Markdown语法规则: ...

  10. MarkDown 使用指南

    https://frankbing.gitbooks.io/markdown/content/

随机推荐

  1. 5. `sklearn`下的线性回归

    本文以线性回归为例,介绍使用sklearn进行机器学习的一般过程. 首先生成模拟数据 import numpy as np def get_data(theta_true,N): X=np.rando ...

  2. idea中一些常用的快捷键

    ctrl+shift+alt:多行操作psvm:生成main()方法:fori:生成for循环:Ctrl+Alt+v:自动补齐返回值类型ctrl+o:覆写方法ctrl+i:实现接口中的方法ctrl+s ...

  3. 利用XtraDiagram.DiagramControl进行流程图形的绘制和控制

    DevExpress提供了一个比较强大的图形绘制工具,可以用于绘制各种图形,如流程图.组织机构图等等,本篇随笔介绍XtraDiagram.DiagramControl的使用,以及利用代码对其属性进行控 ...

  4. Vue数据双向绑定原理(vue2向vue3的过渡)

    众所周知,Vue的两大重要概念: 数据驱动 组件系统 1 2 接下来我们浅析数据双向绑定的原理 一.vue2 1.认识defineProperty vue2中的双向绑定是基于definePropert ...

  5. element ui 自定义主题失败(primordials is not defined)

    卸载: 1.卸载cnpm npm uninstall cnpm -g 2.卸载vue-cli npm uninstall @vue/cli -g 3.卸载nodejs和删除文件 C:\Program ...

  6. SAP Using Text Modules in Adobe Forms

    In this demo we will create an adobe form which displays text in two different languages (English or ...

  7. Metasploit msfvenom

    一. msfvenom简介 msfvenom是msf payload和msf encode的结合体,于2015年6月8日取代了msf payload和msf encode.在此之后,metasploi ...

  8. 文本处理工具-vim编辑器的常见用法

    文本编辑工具分类: (1)全屏编辑器: nano(字符编辑器).vi.vim (2)行编辑器: sed:可以逐行改文件 vi编辑器 全名:Visual editor,linux系统自带的文本编辑工具 ...

  9. OpenLayers入门(一)

    OpenLayers简介 OpenLayers(https://openlayers.org/)是一个用来帮助开发Web地图应用的高性能的.功能丰富的JavaScript类库,可以满足几乎所有的地图开 ...

  10. python是什么?工作前景如何?怎么算有基础?爬数据违法嘛......

    随着python越来越火爆并在2021年10月,语言流行指数的编译器Tiobe将Python加冕为最受欢迎的编程语言,且置于Java.C和JavaScript之上,于是越来越多的人开始了解python ...