一、基本元素
- 标题
- 列表:有序列表、无序列表,嵌套列表
- 引用
- 引用文本
- 嵌套引用文本
- 行内代码
- 多行代码
- 字体和效果
- 强调:粗体、斜体
- 修饰线:下划线、删除线、高亮
- 上标、下标
- 分割线
- 表格
- 链接和图片
- 超链接、图片
- 行内式、参考式
- 自动链接
- 转义
- 公式:行间公式、行内公式
二、基本语法要点
注:1. markdown语法符号大部分为前缀式,字体和效果、代码、公式为括号式,个别为底线式;2. 前缀式后要紧跟一个空格;3. 底线形式的标题和参考式链接的地址部分必须在独立分块中(最简单的方法是在前面添加一个空行);
- 标题:
- #号形式:1级到6级,1到6个#;
- 底线形式:
=
和-
分别表示一级和二级标题
- 列表:
- 有序列表:
1. 2. 3. ...
- 无序列表:
-、+、*
- 嵌套列表:比上一级多两个以上空格则为嵌套列表
- 有序列表:
- 引用
- 引用文本:
>
- 嵌套引用文本:
>>
- 行内代码:`
- 多行代码:```
- 引用文本:
- 字体和效果
- 粗体和斜体:
**、__、*、_
- 下划线、删除线、高亮:
++、~~、==
- 上标、下标:
^、~
- 粗体和斜体:
- 分割线:
***
、---
、___
- 表格:
|
、:
- 链接和图片
- 超链接、图片:
[]()
、![]()
- 行内式、参考式:
[][]
、![][]
- 自动链接:
<>
- 超链接、图片:
- 转义:
\
- 公式:
- 行间公式:
$$
- 行内公式:
$
- 行间公式:
三、示例
标题
- #号形式(推荐)
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
- 底线形式:=和-分别表示一级和二级标题
一级标题
============
二级标题
---------------------
效果:
一级标题
二级标题
注:1. 标题文字上一行不能在同一段内(即前一个元素必须是分块元素,不能是普通文字和行内元素!),最简单实现方法就是前面加一个空行!2. = 和 - 的个数不限;
列表
- 有序列表(1. 2. 3. ...)
代码:
1. 列表项1
2. 列表项2
2. 列表项3
效果:
- 列表项1
- 列表项2
- 列表项3
注:我的代码中第3个序号没写错,确实写的是2,因为即使代码中的序号不对也没关系,但序号最好以1开始,因为markdown以后有可能支持指定起始序号。
- 无序列表(+、-、*)
+ 列表项1
+ 列表项2
+ 列表项3
- 列表项1
- 列表项2
- 列表项3
* 列表项1
* 列表项2
* 列表项3
效果:
- 列表项1
- 列表项2
- 列表项3
- 列表项1
- 列表项2
- 列表项3
- 列表项1
- 列表项2
- 列表项3
- 嵌套列表(比上一级多两个以上空格则为嵌套列表)
代码:
+ 一级列表项1
- 二级列表项1
- 二级列表项2
- 二级列表项3
+ 一级列表项2
* 二级列表项1
* 二级列表项2
* 二级列表项3
+ 一级列表项3
+ 二级列表项1
+ 三级列表项1
+ 三级列表项2
效果:
- 一级列表项1
- 二级列表项1
- 二级列表项2
- 二级列表项3
- 一级列表项2
- 二级列表项1
- 二级列表项2
- 二级列表项3
- 一级列表项3
- 二级列表项1
- 三级列表项1
- 三级列表项2
注:嵌套列表时,可以使用相同的字符,也可以使用不同的字符。
引用
- 引用文本:
代码:
> 引用的内容
效果
引用的内容
- 嵌套引用文本:
> 引用的内容
>> 嵌套引用内容
效果
引用的内容
嵌套引用内容
- 行内代码:
这是`行内代码`效果
效果
这是
行内代码
效果
- 多行代码:
```text
这是多行代码效果
这是多行代码效果
这是多行代码效果
``` - 多行代码:
```text
这是多行代码效果
这是多行代码效果
这是多行代码效果
```
效果:
这是多行代码效果
这是多行代码效果
这是多行代码效果
注:1. 在代码中使用反引号时,只需要使用较多的连续反引号作为起止标记即可!2. 文本(“>”)引用中可以使用其他大多数markdown字符;而代码引用中则不行;3. 文本可以多层嵌套,只需使用多个“>”即可;
字体和效果
- 强调(*、**、_、__,通常一个符号时为斜体,两个符号时为粗体)
斜体:*强调1*,_强调3_
粗体:**强调2**,__强调4__
效果:
斜体:斜体1,斜体2
粗体:粗体1,粗体2
- 下划线、删除线、高亮
下划线:++下划线++
删除线:~~删除线~~
高亮:==高亮==
效果:(简书不支持下划线和高亮)
下划线:++下划线++
删除线:删除线
高亮:==高亮==
- 上标和下标
上标:A^2^
下标:A~2~
效果:
上标:A2
下标:A2
分割线:***
、---
、___
- 分页
***
效果:
- 分节
---
效果:
- 换行
___
效果:
注:1. 中间可以使用空格间隔开;2. 在简书中这几种分割线效果都是一样的;
表格
注:1. 在第2行中可使用“:”设置某列的左、中、右对齐;2. 用“|”来分割列,第1行和第2行中“|”的个数必须相等,最左和最右的“|”可省略;3. 第2行中的“-”的数量不限;
代码:
默认对齐|中间对齐|右对齐
----|:----:|----:
a |b |c
e |f |g
h|i|j
效果:
默认对齐 中间对齐 右对齐 a b c e f g h i j
超链接和图片
- 超链接
超链接格式:[链接文字](链接地址 "链接的title属性值")
示例:
欢迎访问[每水的简书](https://www.jianshu.com/u/2db0e7ca08a4 "一个IT男")
我的文章:[简书markdown基本语法](https://www.jianshu.com/p/717aeeb843cc "本文链接")
效果:
欢迎访问每水的简书
我的文章:简书markdown基本语法
注:简书在预览模式下支持title,而在发布时不支持!
- 图片
图片格式:![alt,在简书中同时也是图片说明](图片地址 "title")
示例:
![海天一色](https://upload-images.jianshu.io/upload_images/19039432-46357069f5085a72.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "plane_over_sea.png")
效果:
注:alt和title可以不写;
- 行内式和参考式
上面插入超链接和图片的方式即为行内式,地址和显示内容写在一起;
参考式则将地址与显示内容分开来写,通常地址集中写在一起;多个显示内容可使用同一个地址;
代码:
我经常去的几个网站[GitHub][1]、[知乎][2]以及[简书][3],[简书][3]是一个不错的[写作社区][],这篇文章首发于[简书][3]。
[1]:https://github.com "GitHub"
[2]:https://www.zhihu.com "知乎"
[3]:http://www.jianshu.com "简书"
[写作社区]:http://www.jianshu.com
效果:
图片也可以使用参考式
这是网上找到的一张图片![海][p1],我非常喜欢这张图片![天][p1],如果图片![一色][p1]侵权,请告知侵删;
[p1]:https://upload-images.jianshu.io/upload_images/19039432-46357069f5085a72.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "plane_over_sea.png"
效果:
这是网上找到的一张图片,我非常喜欢这张图片,如果图片侵权,请告知侵删;
注:1. 参考式的链接地址部分要位于独立块;
- 自动链接:用尖括号
<>
将链接括起来,链接地址与尖括号中的内容一样。
代码:
我的简书:<https://www.jianshu.com/u/2db0e7ca08a4>
效果:
转义
方法:在需要转义的字符前加反斜线\
;
需要转义的字符
\ 反斜线
+ 加号
- 减号
* 星号
. 英文句点
! 感叹号
` 反引号
_ 下划线
() 括号
[] 方括号
{} 大括号
# 井字号
注:代码中的字符不需要转义;
公式
- 行间公式:
格式:$$数学公式$$
示例:
$$e^{i*\pi}+1=0$$
效果:
- 行内公式:
格式:$数学公式$
示例:
三角函数公式$\cos (2\theta) = \cos^2 \theta - \sin^2 \theta$是一个常用的公式;
效果:
三角函数公式是一个常用的公式;