Markdown基本语法

5分钟学会Markdown视频

0. 什么是Markdown

Markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式

  • 易写:不需要用鼠标,通过几个字符就能清楚地设定文章结构,进行文章排版,而且语法极其简单,学习成本非常低,可以轻松的进入沉浸式写作,而不用纠结于排版
  • 易读:Markdown具有极强的兼容性,转换为富文本或者HTML之后还能保持原有的格式。不会出现我是用pages写的,windows打不开,或者我是新版的word写的,旧版的打开后格式有问题这类情况

1. 标题

  • 语法:在想要设置为标题的文字前面加#,一个#是一级标题,二个#是二级标题,以此类推,支持六级标题
  • 示例
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

2. 字体

  • 语法
    • 加粗:要加粗的文字左右分别用2个*号包起来
    • 斜体:要倾斜的文字左右分别用1个*号包起来
    • 斜体加粗:要倾斜和加粗的文字左右分别用3个*号包起来
    • 删除线:要加删除线的文字左右分别用2个~号包起来
    • 下划线:要加下划线的文字用<u></u>包起来
    • 字体加颜色:需要颜色的文字用<font color='red'></font>包起来
  • 示例
**这是加粗的文字**
*这是倾斜的文字*
***这是斜体加粗的文字***
~~这是加删除线的文字~~
<\u>这是加下划线的文字<\/u>   <font color='red'>## 配置时,去掉\ </font>
<\font color='red'>红色<\/font>  <font color='red'>## 配置时,去掉\ </font>
<\font color='blue'>蓝色<\/font>  <font color='red'>## 配置时,去掉\ </font>
<\font color='green'>绿色<\/font>  <font color='red'>## 配置时,去掉\ </font>
  • 效果
    这是加粗的文字
    这是倾斜的文字
    这是斜体加粗的文字
    这是加删除线的文字
    这是加下划线的文字
    红色
    蓝色
    绿色

3. 引用

  • 语法:在引用的文字前加>,引用支持嵌套,如2个>>、3个>>>
  • 示例
> 我是引用
>> 我也是引用
>>> 我还是引用
  • 效果

我是引用

我也是引用

我还是引用

4. 分割线

  • 语法:3个或者3个以上的-或者*都可以
  • 示例
---
----
***
****
  • 效果




5. 图片

  • 语法![图片alt](图片地址 ''图片title'')
    • 图片alt:显示在图片下面的文字,相当于对图片内容的解释
    • 图片地址:图片的url访问地址
    • 图片title:是图片的标题,当鼠标移到图片上时显示的内容;title可加可不加
  • 示例
![uino](https://pan.udolphin.com/files/image/2021/8/b638948780eeaf84f0af9339b1f3a29d.png "看懂新空间")
  • 效果
    uino

6. 超链接

  • 语法[超链接名](超链接地址 "超链接title")
    • 超链接名:显示超链接的名称
    • 超链接地址:超链接的url访问地址
    • 超链接title:title可加可不加
  • 示例
[uino官网](https://www.uino.com/)

7. 列表

  • 语法
    • 无序列表:用 -+* 任何一种都可以,注意-+* 跟内容之间都要有一个空格
    • 有序列表:数字加点,注意序号跟内容之间要有空格
  • 示例
无序列表
- 列表
+ 列表
* 列表

有序列表
1. 列表
2. 列表
3. 列表

列表嵌套
1. 一级有序列表内容
    - 
    - 二级无序列表内容
    - 二级无序列表内容
  • 效果

无序列表
- 列表
+ 列表
* 列表

有序列表
1. 列表
2. 列表
3. 列表

列表嵌套

  1. 一级有序列表内容
    • 二级无序列表内容
    • 二级无序列表内容
    • 二级无序列表内容

8. 表格

  • 语法
    • 第一行是表头
    • 第二行分割表头和内容,-有1个就可以,多一些是为了对齐;文字默认居左
      • 两边加:,表示文字居中
      • 右边加:,表示文字居右
表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容
  • 示例
排名|语言|占有率
---|:--:|---:
1|Java|16.904%
2|C|13.337%
  • 效果
排名 语言 占有率
1 Java 16.904%
2 C 13.337%

常用表格

  • 示例

| 一级分类 | 二级分类 | 三级分类 |
| :---: | :---: | :---: |
| @cols=1:@rows=3:标记点 | 模型标记点 |  |
| @cols=1:@rows=2:图片标记点 | 顶部标题 |
| 右侧标题 |
| @cols=1:@rows=5:连线 | 单线 |  |
| 双线 |  |
| 管状线 |  |
| 轨迹线 |  |
| 围栏 |  |
| @cols=1:@rows=2:面 | 区域面 |  |
| 水面 |  |

  • 效果
一级分类 二级分类 三级分类
@cols=1:@rows=3:标记点 模型标记点
@cols=1:@rows=2:图片标记点 顶部标题
右侧标题
@cols=1:@rows=5:连线 单线
双线
管状线
轨迹线
围栏
@cols=1:@rows=2:面 区域面
水面

有需要的表格,欢迎继续补充~

9. 代码

  • 语法
    • 单行代码:代码之间分别用1个反引号包起来
    • 代码块:代码之间分别用3个反引号包起来,且反引号单独占一行;第一行的反引号后面可以指定一种语言
  • 示例
单行代码
`Hello World!`

代码块,为了防止转译,前后三个反引号处加了小括号,实际是没有的。这里只是用来演示,实际中去掉两边小括号即可
(```javascript)
function run() {
    console.log("Hello World!");
}
(```)
  • 效果

Hello World!

function run() {
    console.log("Hello World!");
}

10. 视频

<video id="video" controls=""  width="800px" height="400px">
    <source id="mp4" src="https://cdn.uino.cn/wiki-video/video-markdown.mp4" type="video/mp4">
</video>

11. 常见问题(FAQ)

常见问题可参考这篇文章:

WIKI 常见问题 https://wiki.uino.com/d/61610602c29820ed9477a50c.html