超神级!Markdown最详细教程,程序员的福音

127 阅读4分钟

image.png

基本语法

标题

(1) # :表示标题。【推荐使用】   

基本语法: # + 空格 + 标题名。 # 的个数表示标题级别,为1-6级。

语法:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

(2) - 或者 = :一级标题/二级标题 【不推荐】   

= 表示二级标题; - 表示一级标题;用至少2个的 - 或者至少2个的 = 进行分割。

语法:
用 - 表示标题----------
用 = 表示标题===========

粗体和斜体

粗体

  • 前后各2个 * 包裹加粗内容。
语法:
**粗体内容**

斜体

  • 前后各1个 * 包裹斜体内容。
语法:
*斜体内容*

列表

有序列表

  • 用 数字序号 + 英文句号 + 空格 + 列表内容 来标记.
语法:
1. 苹果手机
2. 华为手机

无序列表

      • 空格 + 列表内容 表示。
      • 空格 + 列表内容 表示。
      • 空格 + 列表内容 表示。
语法:
+ 无序列表
* 无序列表
- 无序列表

水平线

    • : 三个以上的 - 表示。
    • : 三个以上的 * 表示
  • _ : 三个以上的 _ 表示
------ -表示水平线
****** *表示水平线
______ _表示水平线

块引用

用 > + 空格 表示。注意:有的有时候,不需要空格。多层可以进行嵌套。

语法:
> 第一层
> > 第二层
> > > 第三层
> > > > 第四层

代码块

(1)用 ` 表示。【推荐使用,效果好】(2) 以 Tab 键 表示。【不推荐,效果不明显】(3)4个空格 开头表示。【不推荐,效果不明显】

行内代码块:

(1) 用前后各1个(或2个) ` 包裹代码内容 。

多行代码演示:

(1)用前后各3个 ` 包裹代码内容。

代码演示:
`行内代码
````多行代码```

图片引入

(1)用 ! + [图片说明] + (图片地址) 表示。

代码演示:![测试](D:\Users\Administrator\桌面\images\image-20240130133721558.png)

(2) 用html标签:

<img src="D:\Users\Administrator\桌面images\image-20240130133721558.png" alt="测试" style="zoom:33%;" />

链接

文字链接

  1. 链接文字:真实显示的文字内容。
  2. 链接地址:点击链接文字跳转的地址。
  3. 链接提示:鼠标停留链接文字时,提示说明。
语法:
[百度一下](https://www.baidu.com  "百度地址")
[百度一下](https://www.baidu.com)

网址链接

(1)用 <网址地址> 表示,用 <> 包裹具体网址即可。(2)用 <邮箱地址> 表示,用 <> 包裹邮箱地址即可。

语法:
<http://www.baidu.com> 网址地址。
<baidu@163.com> 邮箱地址。

超索引链接

(1)用 链接文字 表示。

  1. 链接文字:加超链接效果的文本。
  2. 超索引定义:真实的指向网址地址定义。
语法:
[参见百度官网][target]
[target]:http://www.baidu.com "鼠标停留文字显示"

表格

用多个 | 进行分割,表示单元格。用 - 和 : 进行组合表示对齐方式。 注意:完整的表格需要至少由单元格和对其方式组成。也就是说至少两行。

  • -: 设置内容和标题栏居右对齐。
  • :- 设置内容和标题栏居左对齐。
  • :-: 设置内容和标题栏居中对齐
代码:
|          chat| A       |    B    | C       |
|-------------:|:--------|:-------:|---------|
|          chat| A       |    B    | C       |
|          chat| A       |    B    | C       |
|          chat| A       |    B    | C       |

任务列表

用 * 或 + 或 - + 空格 + [空格/x] 表示。

  •  表示未选中。 
  •  表示选中。 
代码演示:
- [x] 苹果
- [x]  橡胶
+ [ ] 橘子
* [ ] 菠萝

锚点

(1)对标题标题的设置锚点:用 锚点描述 表示。其中#+ 名称,对应的时1-6级标题的定义。

代码演示:
# 第一章
## 第二节[第一章锚点](#第一章)
[第二节锚点](##第二节)

(2)代码定义锚点:用html代码定义一个唯一的Id,如:跳转到的位置,定义锚点链接。

代码演示:
<span id = "jump">跳转到的位置</span>
[跳转](#jump)

删除文字

(1)用前后各2个 ~ 包裹删除内容。

代码演示:
~~删除内容~~

表情符号

(1)用 : + 符号 + : 表示。注意:部分工具支持,但是在Idea中无法实现。

代码演示:
:smile_cat::signal_strength:

Markdown书写建议:

  1. 文档标题:文档的第一个标题应该是一级标题,写在第一行,建议与文件名相同,标题要尽量简短。
  2. 作者:可选,用于声明文档的作者,如果是开源项目的文档,建议把作者名写在修订历史中。
  3. 摘要:用1~3句话描述文档的核心内容。
  4. 目录:用于快速了解文档的结构,便于导航。
  5. 正文:正文中的标题从二级目录开始,逐级增加,不可跳级,不可相同。

好了,关于Markdown的语法和使用就先讲到这里,如果喜欢,请关注“IT技术馆”。馆长会更新最实用的技术!