【Markdown】新手快速入门基础教程

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](<https://www.cnblogs.com/images/logo_small.gif> ''博客园logo'')

效果:

博客园logo


六、超链接

[超链接名](超链接地址 "超链接title")
title可加可不加

示例:

[百度](http://www.baidu.com)

效果:

百度

七、列表

支持有序列表和无序列表。

无序列表使用星号(*****)、加号(+)或是减号(-)作为列表标记,效果相同。

示例:

* 第一项
* 第二项
* 第三项

效果:

  • 第一项
  • 第二项
  • 第三项

有序列表使用数字并加上 . 号来表示。

示例:

1. 第一项
2. 第二项
3. 第三项

效果:

  1. 第一项
  2. 第二项
  3. 第三项

列表嵌套

列表嵌套只需在子列表中的选项添加四个空格即可。

示例:

1. 第一项:
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项:
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第一个元素

效果:

  1. 第一项:
    • 第一项嵌套的第一个元素
    • 第一项嵌套的第二个元素
  2. 第二项:
    • 第二项嵌套的第一个元素
    • 第二项嵌套的第一个元素

八、代码

单行代码:代码之间分别用一个反引号包起来

代码区块:可以用 ``` 包裹一段代码,并指定一种语言(也可以不指定),也可以使用 4 个空格或者一个制表符(Tab 键)

示例:

`printf("hello")` 

​```python
a = hello world
print(a)
​```

效果:

printf("hello")

a = hello world
print(a)

九、表格

制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。

对齐方式

  • -: 设置内容和标题栏居右对齐。
  • :- 设置内容和标题栏居左对齐。
  • :-: 设置内容和标题栏居中对齐。

示例:

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

效果:

左对齐右对齐居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

参考:http://www.runoob.com/markdown/md-tutorial.html

原文地址:https://www.cnblogs.com/HGNET/p/12003740.html