Markdown介绍
Markdown是一种轻量标记语言,通过简单的语法,使普通文本具有一定的格式;通过文本写出你想要的文字和排版,为用户提供了超高效的沉浸式写作体验.
- 易于阅读,方便创作web文档,利于各平台无缝分发
- 语法灵感最大的来源还是纯文本email的格式,完全由标点符号标签组成的纯文本
- 文件应该以纯文本形式原样发布,不应该包含标记标签和格式化指令
- 内联HTML语法: Markdown语法集合是HTML标签的一小部分
语法
1.特殊字符自动转义
<
和&
等在html中这种特殊符号,遵循html语法进行转义为<
和&
特殊字符 | 描述 | 字符的代码 |
---|---|---|
空格符 | | |
< | 小于号 | < |
> | 大于号 | > |
& | 和号 | & |
¥ | 人民币 | ¥ |
© | 版权 | © |
® | 注册商标 | ® |
°C | 摄氏度 | °C |
± | 正负号 | ± |
× | 乘号 | × |
÷ | 除号 | ÷ |
² | 平方(上标²) | ² |
³ | 立方(上标³) | ³ |
2.注释
- html注释语法
<!-- 这是注释,不会在浏览器中显示 -->
<div style='display: none'> 这是注释,不会在浏览器中显示。 </div>
- hack方法
hack方法就是利用markdown的解析原理来实现注释的
一般有的markdown解析器不支持上面的注释方法,这个时候就可以用hack方法
hack方法比上面2种方法稳定得多,但是语义化太差
[//]: # (哈哈我是最强注释,不会在浏览器中显示。)
[^_^]: # (哈哈我是最萌注释,不会在浏览器中显示。)
[//]: <> (哈哈我是注释,不会在浏览器中显示。)
[comment]: <> (哈哈我是注释,不会在浏览器中显示。)
3.分级标题
# 一级标题
## 二级标题
### 三级标题
### 四级标题
#### 五级标题
##### 六级标题
4.任务列表
1.代码
- [ ] 任务一 未做任务 `- + 空格 + [ ]`
- [x] 任务二 已做任务 `- + 空格 + [x]`
2.显示效果
- 任务一 未做任务
- + 空格 + [ ]
- 任务二 已做任务
- + 空格 + [x]
5.首行缩进
不同特殊占位符所占空白是不一样大的
1.代码
【1】 或 //全角
【2】 或 //半角
【3】 或 //半角之半角
2.显示效果
【1】  或  //全角
【2】  或  //半角
【3】 或  //半角之半角
6.换行
1.在一行字后面添加两个空格` `
2.在一行字后面添加
7.空行
在编辑的时候有多少个空行(只要这一行只有回车或者space没有其他的字符就算空行),在渲染之后,只隔着一行
8.对齐方式
1.代码
行中心对齐
行左对齐
行右对齐
2.显示效果
行左对齐
行右对齐
9.斜体、粗体、删除线、下划线、背景高亮
1.代码
*斜体*或_斜体_
**粗体**
***加粗斜体***
~~删除线~~
++下划线++
==背景高亮==
2.显示效果
斜体或_斜体_
粗体
加粗斜体删除线
++下划线++
==背景高亮==
10.超链接、页内链接、自动链接、注脚
a.行内式
[]里写链接文字,()里写链接地址, ()中的””中可以为链接指定title属性,title属性可加可不加
title属性的效果是鼠标悬停在链接上会出现指定的 title文字,链接地址与title前有一个空格
1.代码
[我的Github](https://github.com/darebeat "darebeat")
2.显示效果
b.参考式
参考式超链接一般用在学术论文上面,或者另一种情况,如果某一个链接在文章中多处使用,
那么使用引用 的方式创建链接将非常好,它可以让你对链接进行统一的管理
语法说明:
参考式链接分为两部分,文中的写法 [链接文字][链接标记],在文本的任意位置添加[链接标记]:链接地址
如果链接文字本身可以做为链接标记,你也可以写成[链接文字][]
[链接文字]:链接地址的形式,见代码的最后一行
友情链接[简书][1]、[码云][2]
[1]:https://www.jianshu.com/u/0ce823f0ab53
[2]:https://gitee.com/darebeat
显示效果:
c.注脚
语法说明:
在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。 然后在文本的任意位置(一般在最后)添加脚注,脚注前必须有对应的脚注名字
注意:经测试注脚与注脚之间必须空一行,不然会失效。成功后会发现,即使你没有把注脚写在文末,经Markdown转换后,也会自动归类到文章的最后
1.代码
使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2]
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
2.显示效果
使用 Markdown^1可以效率的书写文档, 直接转换成 HTML[^2]
[^2]:HyperText Markup Language 超文本标记语言
11.插入图像
语法中图片Alt的意思是如果图片因为某些原因不能显示,就用定义的图片Alt文字来代替图片 图片Title则和链接中的Title一样,表示鼠标悬停与图片上时出现的文字
Alt 和 Title 都不是必须的,可以省略,但建议写上
1.代码
2.显示效果
12.多级引用
语法说明:
引用需要在被引用的文本前加上>符号和空格,允许多层嵌套,也允许你偷懒只在整个段落的第一行最前面加上
>
1.代码
> 请问 Markdwon 怎么用? - 小白
>> 自己看教程! - 愤青
>>> 教程在哪? - 小白
2.显示效果
请问 Markdwon 怎么用? - 小白
自己看教程! - 愤青
教程在哪? - 小白
13.转义字符、字体、字号、颜色
a.转义字符
Markdown中的转义字符为\,转义的有:
\ 反斜杠 ` 反引号 * 星号 _ 下划线 {} 大括号 [] 中括号 () 小括号 # 井号 + 加号 - 减号 . 英文句号 ! 感叹号
b.字体、字号、颜色
1.代码
我是黑体字
我是微软雅黑
我是华文彩云
黑体
gray
null
2.显示效果
我是黑体字
我是微软雅黑
我是华文彩云
黑体
gray
null
14.代码块
用六个`包裹多行代码
```md
code here
```
效果预览如下:
code here
15.表格
语法说明:
不管是哪种方式,第一行为表头,第二行分隔表头和主体部分,第三行开始每一行为一个表格行
列于列之间用管道符|隔开
原生方式的表格每一行的两边也要有管道符
第二行还可以为不同的列指定对齐方向。默认为左对齐,在-右边加上:就右对齐
- 左对齐, :-: 中心对齐,-: 右对齐
1.代码
|学号|姓名|序号|
|-|-|-|
|小明明|男|5|
|小红|女|79|
|小陆|男|192|
2.显示效果
学号 | 姓名 | 序号 |
---|---|---|
小明明 | 男 | 5 |
小红 | 女 | 79 |
小陆 | 男 | 192 |
16.分隔线
一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西
也可以在星号或是减号中间插入空格
1.代码
* * *
***
*****
- - -
-----------
2.显示效果
17.插入视频
<video controls="" autoplay="" name="media" style="width:100%;">
<source src="https://kiftd.darebeat.cn/resourceController/getResource/923f747f-adec-4a54-9b1b-46c8ba0f2819" type="video/mp4">
</video>
18.插入音频
<audio controls="" autoplay="" name="media" style="width:100%;">
<source src="https://kiftd.darebeat.cn/resourceController/getResource/1795b7bb-7726-4d48-875f-9e0091151240">
</audio>