Markdown是一种轻量级的标记语言,它的创始人是John Gruber。Markdown的语法特点是比较简洁易懂的,它的理念是让文档更加的容易读写和更改,我觉得人们在数十分钟内即可快速入门Markdown。以下内容是我的一个较为简单的学习总结。
Markdown最高支持六级标题,其语法格式为在标题文字前加入#和空格。在Typora
里使用快捷键Ctrl+1
可以实现一级标题的标注,余下的二级、三级等标题快捷键以此类推即可。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
####### 六级标题
需要注意的是,当标题级别超过六级,即前方使用七个#,此时的语法已经不能再标注标题,输入的#######和正常的正文文本没有区别。
对于一级和二级标题,还可以使用如下方式进行显示。
一级标题
====
二级标题
---
Markdown通过使用*
和_
包围文本来实现文本的强调加粗和斜体显示,具体语法如下:
*斜体* 或者 _斜体_
**加粗文本** 或者 __加粗文本__
***粗斜体文本*** 或者 ___粗斜体___
这里的*
和_
和文本之间如果是有空白,那么它们不会起到应有的效果。如果确实需要在文本前后加入星号或者底线,可以考虑使用转义符进行实现。转义字符的用处在于,它保留了字符本该有的意义。
\*这是一段前后有星号的文字\*
列表分为有序和无序两种,列表之间还可以进行组合嵌套。
1. 列表项1
2. 列表项1
3. 列表项1
在这里需要注意的是,在数字标注1.和后方列表项需要有一个空格进行隔开才能实现列表项,后面的无序列表的标注符号和列表项亦是如此。
无序列表前面的标注符号可为*、+和-。
* 列表项1
* 列表项2
+ 列表项1
+ 列表项2
- 列表项1
- 列表项2
以上三种语法在编辑器中的结果均为:
* 产品介绍
下方的子项需要以一个制表符或者4个空格缩进之后再书写列表项前方标注
* 产品功能
1. 功能1
2. 功能2
Markdown编辑器中结果为:
列表标注避免歧义:
当首行内容是以日期或者数字起始如:
2015. 公司年度目标规划
,此时为了避免其被转化为有序列表,我们可以在“.”前面加上反斜杠即转义字符来避免歧义。
2015\. 公司年度目标规划
[bing](https://www.bing.com/ "必应")
[ ]中的文本内容表示最终显示在编辑器里的文字
括号中的https://www.bing.com/是要跳转到的目标网页
“必应”表示鼠标悬停在此超链接时显示的文字
此时插入链接的效果如下:
bing
注:
Markdown本身语法不支持连接在新的页面打开,csdn页面点击后网页还是打不开,这里如果要实现跳转,可以使用HTML语言来实现同样的效果。语法如下:
<a href="https://www.bing.com/" target='_blank'>binga>
使用HTML添加的链接即是可以实现跳转的了:
bing
这是一篇`markdown`的学习笔记。
结果是:
这是一篇markdown
的学习笔记。
如果需要高亮的内容本身包含" ` ",则是可以这样来写:
`` `这里` ``
Markdown支持多种语言的语法高亮,如需要在文本中加入代码块,可使用如下示例语法:
```python
import pandas as pd
```
```html
Syntax Highlighting
```
```java
println('Hello world!')
```
以上语法高亮效果如下:
import pandas as pd
<div>Syntax Highlightingdiv>
println('Hello world!')
Markdown支持的代码高亮远不止这些,其余的代码高亮功能还需要读者自行尝试,按照类似的方法,变换语法名称即可。
在Markdown语法中,在需要引用的文字前加入>
即可实现引用效果。语法示例如下:
> 这是一段很长的文字。
结果如下:
这是一段很长的文字。
Markdown的引用可以实现嵌套效果,语法如下:
> 这是第一层文字。
>> 这是第二层文字。
结果如下:
这是第一层文字。
这是第二层文字。
Markdown可使用*
或者是-
来实现一条“华丽的分割线”,具体语法如下:
***
* * *
- - -
结果均为一条分割线,如下所示:
Markdown其实也支持传统的HTML标签,我们在引用的时候也可以写成:
<blockquote>这是使用html语法实现的引用效果blockquote>
我们可以看到,这里使用HTML语法实现的效果是相同的:
这是使用html语法实现的引用效果
这些是本人对Markdown语法的学习笔记和总结,也是本人的第一篇博客。多有不足之处还请各位读者包涵。