Markdown是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。
推荐使用 Typora 编辑器,它支持 MacOS 、Windows、Linux 平台,且包含多种主题,编辑后直接渲染出效果。附上Typora 官网:https://typora.io/
一、标题
使用#号可表示 1-6 级标题,一级标题对应一个#号,二级标题对应两个#号,以此类推。
注:标准语法一般在#后跟个空格再写文字
示例:
# 这是一级标题## 这是二级标题 ### 这是三级标题 #### 这是四级标题 ##### 这是五级标题 ###### 这是六级标题
效果:
这是一级标题
这是二级标题
这是三级标题
这是四级标题
这是五级标题
这是六级标题
二、字体
加粗
文字左右分别用两个*号包起来
斜体
文字左右分别用一个*号包起来
斜体加粗
文字左右分别用三个*号包起来
删除线
文字左右分别用两个~~号包起来
示例:
**这是加粗的文字***这是倾斜的文字*`***这是斜体加粗的文字***~~这是加删除线的文字~~
效果:
这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
这是加删除线的文字
三、引用
在引用的文字前加>即可,引用可以嵌套。
示例:
>这是引用的内容>>这是引用的内容
效果:
这是引用的内容
这是引用的内容
列表中使用
示例:
* 第一项 > 引用1 > 引用2* 第二项
效果:
第一项
引用1
引用2
第二项
四、分割线
三个或者三个以上的 - 或者 * 都可以。
示例:
----
效果:
五、图片
![图片alt](图片地址 ''图片title'')图片alt就是显示在图片下面的文字,相当于对图片内容的解释。图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加
示例:
![博客园logo](</images/logo_small.gif> ''博客园logo'')
效果:
六、超链接
[超链接名](超链接地址 "超链接title")title可加可不加
示例:
[百度]()
效果:
百度
七、列表
支持有序列表和无序列表。
无序列表使用星号(*****)、加号(+)或是减号(-)作为列表标记,效果相同。
示例:
* 第一项* 第二项* 第三项
效果:
第一项第二项第三项
有序列表使用数字并加上.号来表示。
示例:
1. 第一项2. 第二项3. 第三项
效果:
第一项第二项第三项
列表嵌套
列表嵌套只需在子列表中的选项添加四个空格即可。
示例:
1. 第一项: - 第一项嵌套的第一个元素 - 第一项嵌套的第二个元素2. 第二项: - 第二项嵌套的第一个元素 - 第二项嵌套的第一个元素
效果:
第一项: 第一项嵌套的第一个元素第一项嵌套的第二个元素第二项: 第二项嵌套的第一个元素第二项嵌套的第一个元素
八、代码
单行代码:代码之间分别用一个反引号包起来
代码区块:可以用```包裹一段代码,并指定一种语言(也可以不指定),也可以使用 4 个空格或者一个制表符(Tab 键)
示例:
`printf("hello")` ```pythona = hello worldprint(a)```
效果:
printf("hello")
a = hello worldprint(a)
九、表格
制作表格使用|来分隔不同的单元格,使用-来分隔表头和其他行。
对齐方式
-:设置内容和标题栏居右对齐。:-设置内容和标题栏居左对齐。:-:设置内容和标题栏居中对齐。
示例:
| 左对齐 | 右对齐 | 居中对齐 || :-----| ----: | :----: || 单元格 | 单元格 | 单元格 | | 单元格 | 单元格 | 单元格 |
效果:
参考:/markdown/md-tutorial.html