当你穿过了暴风雨,你就不再是原来那个人了 ---村上春树
文章目录
什么是Markdown
Markdown是一种轻量级标记语言,具有纯文本格式语法。它可以转化为多钟输出格式,常见的有Html、pdf、word等,Markdown通常用于格式化自述文件,例如github上常见的README.md文件等
Markdown的特点
- 语法简单
- 统一的描述文件格式(readme.md)-> .md
- 更多玩法:可以用来写博客、网页等(Hexo,Jekyll,hugo)
语法入门
基本语法
Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等
语法用例
标题语法:
一级标题:#
二级标题:###
三级标题:###
......
六级标题:######
段落语法
要创建段落,请使用空白行将一行或多行文本进行分隔
I love markdown
I love writing books
换行语法
与html一致,使用<br>进行换行
字体语法
粗体 ** 或 __
斜体* 或 _
同时可以使用html标签设置字体颜色或者大小
如
红色字体 <font color="red">红色字体</font>
粗体<b>粗体</b>
等
引用语法
要创建块引用,请在段落前添加一个 > 符号。
这是一个块引用
块引用可以包含多个段落。为段落之间的空白行添加一个 > 符号。
如:
>多段引用
>多段引用
多段引用
多段引用
块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号。
如:
> 引用
>>嵌套引用
引用
嵌套引用
注意:块引用可以包含其他 Markdown 格式的元素。并非所有元素都可以使用,你需要进行实验以查看哪些元素有效。
列表语法
有序列表
要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。
1. 有序列表1
2. 有序列表2
3. 有序列表3
注意可以嵌套,如
1. First item
2. Second item
3. Third item
1. Indented item
2. Indented item
4. Fourth item
无序列表
要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。
- First item
- Second item
-------
* First item
* Second item
-------
+ First item
+ Second item
-------
- First item
- Second item
- Third item
- Indented item
- Indented item
- Fourth item
代码语法
要将单词或短语表示为代码,请将其包裹在反引号 (`) 中。
如:
`code`
如果你要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号(``)中。
如:
```code 1 `code2` code 3```
分隔线语法
要创建分隔线,请在单独一行上使用三个或多个星号 (***)、破折号 (—) 或下划线 (___) ,并且不能包含其他内容。
如:
Try to put a blank line before...
---
...and after a horizontal rule.
链接语法
超链接Markdown语法代码
[超链接显示名](超链接地址 "超链接title")
给链接增加 Title
这是一个链接 [Markdown语法](https://markdown.com.cn "最好的markdown教程")。
网址和Email地址
使用尖括号可以很方便地把URL或者email地址变成可点击的链接。
<https://markdown.com.cn>
<fake@example.com>
带格式化的链接
强调 链接, 在链接语法前后增加星号。 要将链接表示为代码,请在方括号中添加反引号。
I love supporting the **[EFF](https://eff.org)**.
This is the *[Markdown Guide](https://www.markdownguide.org)*.
See the section on [`code`](#code).
最佳用法
不同的 Markdown 应用程序处理URL中间的空格方式不一样。为了兼容性,请尽量使用%20代替空格
[link](https://www.example.com/my%20great%20page)
图片语法
要添加图像,请使用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。
插入图片Markdown语法代码:[![图片alt](图片链接 "图片title")
给图片增加链接,请将图像的Markdown 括在方括号中,然后将链接添加在圆括号中。
[![沙漠中的岩石图片](/assets/img/shiprock.jpg "Shiprock")](https://markdown.com.cn)
转义字符语法
要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 \ 。
\* Without the backslash, this would be a bullet in an unordered list.
注意:虽然markdown可以嵌套html语法,但是出于安全原因,并非所有 Markdown 应用程序都支持在 Markdown 文档中添加 HTML。如有疑问,请查看相应 Markdown 应用程序的手册。某些应用程序只支持 HTML 标签的子集。
markdown 对于 HTML 的块级元素 <div>、<table>、<pre> 和 <p>,请在其前后使用空行(blank lines)与其它内容进行分隔。尽量不要使用制表符(tabs)或空格(spaces)对 HTML 标签做缩进,否则将影响格式。 在 HTML 块级标签内不能使用 Markdown 语法。例如 <p>italic and **bold**</p> 将不起作用