因为在简书上写文章需要使用到MarkDown,但是我对MarkDown语法不熟,所以写下这一篇《MarkDown 基础语法》以供需要时查阅。正所谓 "纸上得来终觉浅, 绝知此事要躬行"虽然现在网上关于markDown语法的文章有很多,但是我觉得还是应该自己整理一篇以加深印象。此外这既是我第一使用markDown也是第一次写文章,所以各位如果有什么意见或者建议都可以在下方发评论区里评论。
这篇文章暂时就罗列出下面十二块,可能有些内容还没有写到,等用的时候如果发现了一些新内容、细节或者错误我会再对这篇文章进行添加和修改。
一 标题
MarkDown标题有两种写法:
- 在文本前使用 # 字符
- 在文本下一行使用等号和减号
- 使用 # 标记,可以表示1-6级标题。一级标题使用一个 # 号,二级标题使用两个 # 号,以此类推。也可以在标题文本的前后都加上 # 号,不过文本前的 # 号数量决定标题的级数,文本后的 # 做修饰使用,数量不限。
# 一级标题
# 一级标题 #
# 一级标题 #####
## 二级题标
### 三级题标
#### 四级题标
##### 五级题标
###### 六级题标
一级标题 (26px)
二级标题 (24px)
三级题标 (22px)
四级题标 (20px)
五级题标 (18px)
六级题标 (16px)
- 使用 等号(=) 和 减号(-) 标记一级和二级标题,任何数量的 等号(=)和减号(-)都可以有效果
一级标题
=
一级标题
=======
二级标题
-
二级标题
-----------
一级标题 (26px)
二级标题 (24px)
二 分隔线 删除线 下划线
- 分隔线有如下三种写法(可以在星号减号或是下划线中间插入空格, 但是同一行不能有其他内容,空格除外):
- 在同一行中使用三个以上的 * 号
- 在同一行中使用三个以上的 减号 (-) 注:要在减号中间加入空格,不然会被解析成二级标题
- 在同一行中使用三个以上的 下划线线(shift + -) 注:输入法要切换成英文输入状态
测试文本
***
测试文本
- - -
测试文本
___
测试文本(星号)
测试文本(减号)
测试文本(下划线)
- 删除线
- 在需要删除的文字的两端加上两个波浪线 ~~ 即可
~~测试文本~~
这是一个阳光明媚的~~早晨~~
测试文本
这是一个阳光明媚的早晨
- 下划线
- 下划线可以通过 HTML 的 <u> 标签来实现(但是本站好像不支持)
<u>测试文本</u>
<u>测试文本</u>
三 脚注(脚注是对文本的补充说明)
- 脚注的格式 [^要注明的文本] (悬停会有完整的信息展示,但是本站好像不支持)
今天天气很好[^测试]
今天天气很好[^测试]
四 字体样式(斜体 粗体 粗细体)
- 斜体(在文本前后都加上 * 号 或者 _ 注:符号都只能加一个且符号与文本之间不能有空格)
*斜体文本*
_斜体文本_
测试文本
测试文本
- 粗体(在文本前后都加上两个 * 号 或者两个 _ 注:符号都只能加一个且符号与文本之间不能有空格 )
**粗体文本**
__粗体文本__
粗体文本
粗体文本
- 粗斜体(在文本前后都加上三个 * 号 或者三个 _ 注:符号都只能加一个且符号与文本之间不能有空格 )
***粗斜体文本***
___粗斜体文本___
粗体文本
粗体文本
五 列表(有序列表 无序列表 嵌套列表)
- 有序列表(数字加上点符号) 可有时我们会出现这样的情况,首行内容是以日期或数字开头:2019. 公司年度总结。
为了避免也被转化成有序列表,我们可以在"."前加上反斜杠(转义符):2017. 公司年度目标。
1. 第一项
2. 第二项
3. 第三项
4\. 第三项
- 第一项
- 第二项
- 第三项
2019. 公司年度总结
2019\. 公司年度总结
2019. 公司年度总结
2019. 公司年度总结
2.无序列表(在文本前使用星号(*)、加号(+)或是减号(-)作为列表标记)(注:三种符号可以混用,但是间距比较大而且符号与文本之间必须要有一个空格)
* 第一项
* 第二项
+ 第三项
- 第四项
- 第一项
- 第二项
- 第三项
- 第四项
- 第五项
- 第六项
- 嵌套列表(列表嵌套只需在子列表中的选项添加四个空格即可) (示例依次是:有序套无序,无序套无序,无序套有序)
1. 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2. 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第一个元素
3. 第三项:
第二项嵌套的第一个元素
第二项嵌套的第一个元素
- 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
- 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第一个元素
- 第三项():
第二项嵌套的第一个元素
第二项嵌套的第一个元素
* 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
* 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第一个元素
- 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
- 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第一个元素
* 第一项:
1. 第一项嵌套的第一个元素
2. 第二项嵌套的第二个元素
- 第三项:
- 第三项嵌套的第一个元素
- 第三项嵌套的第二个元素
六 区块(区块 区块嵌套 区块中使用列表 列表中使用区块)
- 区块引用是在段落开头使用 大于符(>) 符号 ,然后后面紧跟一个空格符号,第二行使不使用大于符(>)都可以
> 测试文本
测试文本
> 测试文本1
> 测试文本2
> 测试文本1
测试文本2
测试文本1
测试文本2
测试文本1
测试文本2
- 区块嵌套 大于符(>) 符号是最外层,两个大于符(>) 符号是第一层嵌套,以此类推
> 第一层1
> 第一层2
>> 第二层
>>> 第三层
第一层1
第一层2第二层
第三层
- 区块中使用列表
> 区块中使用列表
> 区块中使用列表
> 1. 第一项
> * 第一项子项一
> * 第一项子项二
> 2. 第二项
> * 第一项
> * 第二项
区块中使用列表
- 第一项
- 第一项子项一
- 第一项子项二
- 第二项
- 第一项
- 第二项
- 列表中使用区块(如果要在列表项目内放进区块,那么就需要在 大于符(>) 前添加四个空格的缩进。如果没有缩进的话区块和列表就显示为同一级)
* 第一项
> 菜鸟教程
> 学的不仅是技术更是梦想
* 第二项
> 菜鸟教程
> 学的不仅是技术更是梦想
- 第一项
菜鸟教程
学的不仅是技术更是梦想 - 第二项
菜鸟教程
学的不仅是技术更是梦想
七 代码(单行代码 代码块)
- 单行代码,如果是段落上的一个函数或片段的代码可以用反引号把它包起来(
)
condole.log()` 函数 - 代码块
- 使用 ``` 包裹一段代码,并指定一种语言(也可以不指定, 指定之后可以识别语言,代码和语法高亮)
```html
<div>Syntax Highlighting</div>
$(document).ready(function () {
console.log('测试文本');
});
$(document).ready(function () {
console.log('测试文本');
});
- 代码区块使用 4 个空格或者一个制表符(注:没试出来效果)
八 链接(链接 高级链接)
- 链接
展示中文标题 语法:[链接名称](链接地址) [百度](https://www.baidu.com) 不展示中文标题 语法:<链接地址> <https://www.baidu.com>
- 高级链接(定义变量保存链接地址)
定义变量语法:[链接的名字]: 链接的地址 使用的语法: [百度][链接的名字] 例如: [baidu]: https://www.google.com/ [百度][baidu]
九 图片
- 直接使用(直接使用自带的插入图片更方便)
语法:![图片标题](图片地址 "悬停提示 img标签alt属性效果") ![测试.jpeg](https://upload-images.jianshu.io/upload_images/18865456-b1dbf71b247b27f9.jpeg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 '测试.jpeg') 开头一个感叹号 ! 接着一个方括号,里面放上图片的标题 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的 'title' 属性的文字。
- 高级链接(定义变量保存链接地址)
定义变量语法:[变量名]: 图片的地址 使用的语法: ![图片标题][变量名] 例如: [img]: https://upload-images.jianshu.io/upload_images/18865456- b1dbf71b247b27f9.jpeg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 '测试.jpeg' ![测试][img]
十 表格 (基本表格 设置对齐方式)
- 基本表格
制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行, - 数量不限,空格可有可无
|姓名|年龄|性别|
|---|---|---|
|张三|17|男|
|李四|22|女|
姓名 | 年龄 | 性别 |
---|---|---|
张三 | 17 | 男 |
李四 | 22 | 女 |
- 设置对齐
-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。
| 姓名 | 年龄 | 性别 |
| -: | :- | :-: |
| 张三 | 17 | 男 |
| 李四 | 22 | 女 |
姓名 | 年龄 | 性别 |
---|---|---|
张三 | 17 | 男 |
李四 | 22 | 女 |
十一 换行
可以使用</br>标签
测试<br />文本
测试<br />文本
十二 转义
在符号前插入反斜杠()来插入一些在语法中有其它意义的符号
*测试文本*
\*测试文本\*
+ 加号
\+ 加号
测试文本
*测试文本*
- 加号
+ 加号
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\反斜杠
`反引号
*星号
_下划线
{}花括号
[]方括号
()括弧
#井字号
+加号
-减号
.英文句
!感叹号