【markdown】markdown常用语法

辛才俊
2023-12-01

markdown使用

开始学习编写markdown,如有错误,还请指正,非常感谢!


一, 标题

markdown中标题有6级,几级标题就使用几个 #

# 一级目录
## 二级目录
### 三级目录
#### 四级目录
##### 五级目录
###### 六级目录

二,分隔符

markdown中使用三个或三个以上的 -_<br><hr>等设置分隔符。

---
___
***
<br>
<hr>

显示出来就是分割线


三, 序列

markdown可以设置有序序列和无序序列。
有序序列的格式是:数字. 内容, .和内容之间要有一个空格,如下:

  1. 内容1
  2. 内容2
  3. 内容3

无序序列的格式是:-/+/* 内容内容前面要有一个空格,如下:

- 内容1
- 内容2
- 内容3

+ 内容1
 + 内容1.1
  + 内容1.1.1
+ 内容2
+ 内容3

* 内容1
* 内容2
* 内容3

显示出来就是:

  • 内容1
  • 内容2
  • 内容3
  • 内容1

    • 内容1.1
      • 内容1.1.1
  • 内容2

  • 内容3

  • 内容1
  • 内容2
  • 内容3

四, 文字强调——粗体、斜体、删除线等

  • 文字两端用一个*_包起来,中间的文字会显示为斜体
  • 文字两端用两个*``_包起来,中间的文字会显示为粗体
  • 文字前加上~,后面的文字会有删除线;

如下:

*斜体*
_斜体_
**粗体**
__粗体__

显示结果就是:

斜体
斜体

粗体
粗体

五,超链接

markdown添加超链接的格式为:

[描述文字](URL地址 "链接title")

示例:

[bing主页](https://cn.bing.com/ "bing搜索")

显示出来如下,可以点击转到bing主页

bing主页

六, 图片

markdown中插入图片与超链接类似,不同在于图片前面要加一个感叹号。

![图片描述](图片地址 "图片title")

七, 代码

markdown中代码使用反引号 ` 括起来,并且可以指定代码使用的语言。

  • 单行代码块前后用一个反引号括起来;
  • 多行代码块前后用三个反引号括起来;
    如:
`printf();`
\```
#include <stdio.h>
#include <stdlib.h>
\```

显示出来的结果为:

printf();

#include <stdio.h>
#include <stdlib.h>

八,引用

markdown中在文本前加上加括号 > 可以设置文本为引用。

>引用内容

显示为

引用内容

九, 表格

9.1 基础格式

markdown中设置表格比较麻烦,基础格式如下:

| 标头1 | 标头2 | 标头3 |
| ----- | ----- | ----- |
| data1 | data2 | data5 |
| data3 | data4 | data6 |

显示为:

标头1标头2标头3
data1data2data5
data3data4data6

9.2 表格内容对齐

markdown中某一列对齐可以使用冒号:

  • 左边加冒号表示左对齐;
  • 右边加冒号表示右对齐;
  • 左右都加冒号表示居中对齐;

如果需要整个表格对齐,也可以使用html格式的表格写法,markdown和html是通用的。
如下,html代码可以使整张表格居中。

<style>
.center
{
	width: auto;
	display: table;
	margin: auto;
}
</style>

<div class='center'>

项目|value
----|-----
电脑|¥1600
手机|¥234
平板|¥123
</div>

显示结果:

项目value
电脑¥1600
手机¥234
平板¥123

9.3 表格中包含竖线、换行

  • 使用&#124;代替表格中出现的竖线;
  • 使用html中的<br>代替换行;

如下:

标题1 | 标题2
:----------------:|---------:
|内容1&#124;内容3|值1<br>值3|
|内容2|值2|

结果显示:

标题1标题2
内容1|内容3值1
值3
内容2值2

9.4 合并单元格

markdown没有合并单元格的语法,但是markdown兼容html,所以可以使用html的方式实现单元格合并。

首先看下html中的表格基础语法,如下,其中:

  • <tr></tr>标签中间的是一行;
  • <td></td>标签中间的是一列;

所以如下html代码实际显示的是一个表格

<table>
    <tr>
        <td>row1_col1</td>
        <td>row1_col2</td>
        <td>row1_col3</td>
    </tr>
    <tr>
        <td>row2_col1</td>
        <td>row2_col2</td>
        <td>row2_col3</td>
    </tr>
    <tr>
        <td>row3_col1</td>
        <td>row3_col2</td>
        <td>row3_col3</td>
    </tr>
</table>

显示表格:

row1_col1row1_col2row1_col3
row2_col1row2_col2row2_col3
row3_col1row3_col2row3_col3
  • colspan:合并行,规定单元格可以纵跨的列数,跨几列合并行;
    rowspan:合并列,规定单元格可以横跨的行数,跨几行合并列;

如下html代码:

<table>
    <tr>
        <td>row1_col1</td>
        <td>row1_col2</td>
        <td>row1_col3</td>
    </tr>
    <tr>
        <td>row2_col1</td>
        <td colspan="2">跨两列合并</td>
    </tr>
    <tr>
        <td colspan="3">跨三列合并</td>
    </tr>
    <tr>
        <td>row3_col1</td>
        <td>row3_col2</td>
        <td>row3_col3</td>
    </tr>
    <tr>
        <td rowspan="2">合并两行</td>
        <td>row3_col2</td>
        <td>row3_col3</td>
    </tr>
    <tr>
        <td>row3_col1</td>
        <td>row3_col2</td>
    </tr>
</table>

显示的表格:

row1_col1row1_col2row1_col3
row2_col1跨两列合并
跨三列合并
row3_col1row3_col2row3_col3
合并两行row3_col2row3_col3
row3_col1row3_col2
 类似资料: