Markdown 语法手册

Markdown 简介

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
Markdown 语言在 2004 由约翰·格鲁伯(John Gruber)创建。
Markdown 的设计哲学是可读性。
Markdown 支持原生 HTML 标签.
vscode侧边预览markdown的插件:markdown-preview-echanced1
附:官网2、中文指南3、菜鸟教程4
——2023.04.21,@ivcc admin

Markdown 语法手册

1 标题

使用 # 来定义标题,一共有 1-6 级标题。语法:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

另一种语法:

一级标题
=================
二级标题
-----------------

2 段落、换行与分割线

段落是多个相关句子组成,使用空行分隔不同的段落。
换行在句末输入两个或更多空格然后回车。
使用三个或更多的星号(*)、减号(-)、底线(_)来创建一条分隔线

***
---
_________________

3 字体

(1)语法:

*斜体*
_斜体_

**粗体**
__粗体__

***粗斜体***
___粗斜体___

~~删除线~~

下划线

(2)使用 HTML 的 标签可以设置字体颜色文本:

  • color_name 为颜色名称或 RGB 值
  • 支持的颜色名称包括:red、blue、green、yellow 等
  • RGB 值使用格式 #RGB 或 #RRGGBB
浅红色文字 

浅红色文字 浅绿色文字 浅蓝色文字 浅紫色文字

4 引用与脚注

使用 > 来定义块引用:

> 引用 

使用多个 > 来实现嵌套引用:

> 引用
>> 嵌套引用

脚注语法:

iv创客官网 [^1]。

[^1]: www.ivcc.cc

5 列表

使用 *,+- 来定义无序列表:

* 项目一 
* 项目二
* 项目三

使用数字加 . 来定义有序列表:

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

列表嵌套只需要在子列表项前添加四个空格:

1. 项目一 
    - 项目1
    - 项目2
    - 项目3
2. 项目二 
3. 项目三

6 代码

行内代码单个或多个反引号```````连续包裹内容:

`abc`

代码块使用三个或以上反引号换行包括内容,开头的三个反引号后面可以跟上语言名称:

```python
import os
list1 = os.listdir()
print(list1)
```            -

代码区块也可以使用 4 个空格或者一个制表符(Tab 键)

7 图片

(1) 使用 ![alt](src "title") 来定义图片:

  • alt:图像无法显示时的替代文本,用于提高可访问性。
  • src:图像的URL地址,用于显示图像。
  • title:鼠标悬停时显示的提示文本,可选。
![flower](flower.jpg)
![flower](flower.jpg "花的图片")

(2) 使用{: style="..."}的方式内联添加样式

![flower](flower.jpg){: style="float:right; margin:0 0 0 10px; width:30%"}

(3) 可以在 标签中直接添加 HTML 属性来设置图片尺寸和布局:

flower
 

  • 第一个图像指定了200像素的固定宽高
  • 第二个图像使用样式float:rightmargin来实现右对齐,并指定了30%的宽度
  • 第三个图像使用了align="middle"来居中显示(Markdown也支持已废弃的HTML属性)

8 链接

使用 [alt](src "title") 来定义链接:

  • alt:链接描述。
  • src:链接地址。
[iv创客官网](https://www.ivcc.cc)

使用 <> 定义链接,尖括号内为链接地址(此方式没有描述,直接显示链接地址):


说明:Markdown本身语法不支持链接在新页面打开,可以用html语言的a标签代替:
链接描述

9 表格

(1)使用 | 来定义表格,使用 - 来分割 表头和单元格:

| 栏目1  |  栏目2 |     栏目3 |
| :-: | :-: | :-: |
| 单元格1| 单元格2| 单元格3|
  • :-: 居中对齐
  • :- 左对齐
  • -: 右对齐

(2)单元格中可以结合字体语法、行内代码语法使用
(3)高级语法

  • 跨行和跨列
  • 嵌套表格

  1. Markdown Preview Enhanced:https://shd101wyy.github.io/markdown-preview-enhanced/#/zh-cn/, 是一款为 Atom 以及 Visual Studio Code 编辑器编写的超级强大的 Markdown 插件。 这款插件意在让你拥有飘逸的 Markdown 写作体验。 ↩︎

  2. 官网:https://daringfireball.net/projects/markdown/ ↩︎

  3. 中文指南:https://www.markdown.xyz/ ↩︎

  4. 菜鸟教程:https://www.runoob.com/markdown/md-tutorial.html ↩︎

你可能感兴趣的:(开发语言)