markdown 基本语法笔记
基本语法
Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等。
在线体验在线markdown编辑器
Markdown的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握,而就是这十个不到的标记符号,却能让人优雅地沉浸式记录,专注内容而不是纠结排版,达到「心中无尘,码字入神」的境界。
标题语法
要创建标题,在单词或短语前面添加井号(#)。#号的数量代表了标题的级别。为了兼容考虑,用一个空格在#和标题之间进行分隔
段落语法
创建段落,使用空白行将一行或多行文本进行分隔
换行语法
在一行的末尾添加两个或者多个空格,然后按回车键,即可创建一个换行。或者添加HTML标签“<br>”也可换行。(换行在宇宙第一编辑器vscode中,单击enter键会自动识别为换行,但是在mac版vscode中则需要添加空格后换行)
强调语法
markdown的强调语法仅包含斜体和粗体。
粗体(Bold)使用两个星号(**)或两个下划线(__)将文本包含起来即可。如**这是粗体文本**或者__这是粗体文本__会被渲染为这是粗体文本
斜体(Italic)使用一个星号(*)或一个下划线(_)将文本包含起来即可。如*这是斜体文本*或者_这是斜体文本_会被渲染为这是斜体文本
引用语法
单个段落引用
创建引用,在段落之前添加一个>符号即可。如">这是一段引用"会被渲染为
这个是一段引用
多个段落引用
多个段落的引用需要在段落之间的空白行添加>符号。
如
>第一个段落的引用
>
>第二个段落的引用
会被渲染为:
第一个段落的引用
第二个段落的引用
引用的嵌套
引用可进行嵌套,在要嵌套的段落前添加一个>>符号。
如
>第一级引用
>
>>第二级引用
>
>>>第三级引用
会被渲染为:
第一级引用
第二级引用
第三级引用
引用中可包含其他元素
在引用中可以包含其他markdown格式的元素。but并非所有元素都可以使用,需要实践。
如
> #### 这是一个四级标题
> - 无序列表
> 1. 有序列表
> *斜体* **粗体**
> ...
会被渲染为:
这是一个四级标题
- 无序列表
- 有序列表
斜体 粗体
…
列表语法
有序列表
在每个列表项前添加数字(该数字不需要安装序号顺序)并紧跟一个英文句号和一个空格。
如
1.第一个列表项
1.第一个列表项
1.第一个列表项
或者
1.第一个列表项
2.第一个列表项
3.第一个列表项
或者
1.第一个列表项
3.第一个列表项
88.第一个列表项
都会被渲染为:
- 第一个列表项
- 第一个列表项
- 第一个列表项
列表的嵌套:
1. 第一个列表项
1. 第一个列表项子项1
2. 第一个列表项子项2
2. 第二个列表项
- 第一个列表项
- 第一个列表项子项1
- 第一个列表项子项2
- 第二个列表项
无序列表
在每个列表项前面添加一个破折号(-)、星号(*)或者加号(+)。缩进一个或多个列表项可创建嵌套列表。
如
- 无序列表
- 无序列表
* 无序列表
* 无序列表
+ 无序列表
+ 无序列表
均被渲染为
- 无序列表
- 无序列表
- 无序列表
- 无序列表子项
- 无序列表子项
- 无序列表子项的子项
- 最多四级啦
- 无序列表
- 无序列表
- 无序列表子项
- 无序列表子项
- 无序列表子项的子项
- 最多四级啦
- 无序列表子项的子项
- 无序列表
代码语法
单词或短语将其包含在(`)中,代码块则包含在(```)中,并写上代码的类型,如(```html)。
<!DOCTYPE html>
<html>
<head>
<meta charset=“UTF-8”>
<title>这是一个HTML5的网页
</head>
<body>
<p>Hello HTML5</p>
</body>
</html>
渲染为:
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>这是一个HTML5的网页</title>
</head>
<body>
<p>Hello HTML5</p>
</body>
</html>
分割线语法
跟word创建分割线类似,使用三个或多个(***)、破折号(---)或下划线(___),不能包含其他内容。
***
---
___
******
链接语法
链接的文本放在中括号([])中,链接地址放在紧挨在中括号后的括号中,链接的title可选。[超链接显示的文本](超链接地址 "超链接的title属性")
。
超链接显示的文本,鼠标移到此处显示超链接的title,点击跳转到超链接地址
图片语法
添加图片格式:![图片alt文本](图片链接 "图片的title属性")
![这是一张在线的图片,图片无法加载时会显示该文本](https://img-blog.csdnimg.cn/4078d8d2161d4dc6aaab8fe2e5843a75.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5LiA5Y-q5pyI5pyI6bif5ZGA,size_20,color_FFFFFF,t_70,g_se,x_16 "图片的title属性,鼠标移入显示")
![这是一张在线的图片,图片无法加载时会显示该文本](httpGA,size_20,color_FFFFFF,t_70,g_se,x_6 "图片的title属性,鼠标移入显示")
转义字符语法
在我们正文中需要使用到markdown的关键字时,可在前面加一个\符号,即可转义该字符。在使用到markdown关键字的时机加上\符号即可,如"`“就需要写为”\`"