【用Rust写CAD】第二章 第一个Rust程序 第三节 markdown语法

Rust注释支持markdown语法,本节介绍一下Markdown 标题、段落、列表、标题、公式、图片、超链接、上下标、甘特图、流程图、选择框等语法。

文章目录


1、 标题

Markdown使用#符号表示标题,其中#号必须在行首,后面必须跟空格。#的数量表示标题的级别。例如:

复制代码
 # 一号标题
 ## 二号标题
 ### 三号标题
 #### 四号标题
 ##### 五号标题
 ###### 六号标题

效果如下

注意,还可以使用3个"="和3个"-"分别表示一级和二级标题,这种表方法用的少。例如:

复制代码
一级标题
===
二级标题
---

效果如下

2、段落

段落的换行通常需要使用两个空格加上回车,或者在文本之间添加一个空行。

3、 字体

3.1、斜体

使用一个*或_将内容包起来,如*斜体文本*或_斜体文本_:斜体文本。

3.2、粗体

使用两个**或__将内容包起来,如 **粗体文本**或__粗体文本__: 粗体文本。

3.3、粗斜体

使用三个***或___将内容包起来,如***粗斜体文本***或___粗斜体文本___:粗斜体文本

3.4、 删除线

使用两个~~将内容包起来,如~~删除线文本~~:删除线文本。

4、 列表

4.1、无序列表

使用*、+或-符号加上空格来表示,如:

复制代码
	+ 项目1
	+ 项目2
	+ 项目3

效果如下:

  • 项目1
  • 项目2
  • 项目3

4.2、 有序列表

使用数字加.符号来表示,如:

复制代码
1. 项目1
2. 项目2
3. 项目3

效果如下:

  1. 项目1
  2. 项目2
  3. 项目3

4.3、列表嵌套

列表还可以进行嵌套,通过在子列表项前添加额外的空格或Tab键来实现。如:

复制代码
- 项目1
  - 嵌套1
  - 嵌套2
      - 再嵌套
- 项目2

效果如下

  • 项目1
    • 嵌套1
    • 嵌套2
      • 再嵌套
  • 项目2

5、 分隔线

Markdown中可以使用三个或以上的*、-或_来表示分隔线,我推荐用下划线_为佳,因为粗斜体用到*、二级标题用到 -。_表示如下:

复制代码
___

效果:


6、表格

Markdown中的表格使用|来分隔不同的单元格,使用-来分隔表头和其他行,用:表示文字对齐方式。如:

复制代码
| 表头1 | 表头2 |表头3 |
| ---- | :---- |----:|
| 居中对齐 | 左对齐 |右对齐|
| 1 | 2 |3|

效果如下:

表头1 表头2 表头3
居中对齐 左对齐 右对齐
1 2 3

7、代码

7.1、单行代码

使用反引号`将代码包裹起来,如:

复制代码
`print('Hello World!')`。

7.2、代码区块

使用三个反引号```````````包裹一段代码,并可以指定语言。

8、引用

Markdown使用>符号来表示引用,如:

复制代码
> 这是一个引用
>> 这是一个嵌套的引用

效果如下:

这是一个引用

这是一个嵌套的引用

9、任务列表

使用- 表示未完成的任务,使用- x表示已完成的任务,如:

复制代码
- [ ] 任务1
- [x] 任务2

效果如下:

  • 任务1
  • 任务2

10、链接

Markdown支持两种形式的链接:

10.1、行内形式

如

复制代码
[链接文字](链接地址 "标题"),如[百度](https://www.baidu.com "百度首页")

10.2 参考形式

如

复制代码
[链接文字][链接名称],然后在文档末尾添加[链接名称]: 链接地址 "标题",如[百度][1]和[1]: https://www.baidu.com "百度首页"。

11、图片

插入图片的语法与链接类似,但需要在前面加上一个!,如:

复制代码
![图片描述](图片地址 "图片标题")

或者使用参考形式:

复制代码
![图片描述][图片名称]
[图片名称]: 图片地址 "图片标题"
相关推荐
JianZhen✓38 分钟前
IM 聊天列表为什么总“消息乱跳“:有序插入、时间轴派生、本地截断、已读回执
开发语言·前端·php
FungLeo44 分钟前
FengCMS · PHP+MySQL 升级实录· 代码审计怎么闭环:REVIEW到 CLOSURE 四件套,12 个域90 篇修复文档跟到底
开发语言·mysql·php·代码审计·fengcms
七夜zippoe1 小时前
多轮对话管理:Session/记忆在 Java 后端怎么存(存储设计实战)
java·开发语言·ai·session·记忆
屿华AI1 小时前
AUTOSAR 实战-诊断工具 | 基于 Python 与 USB-CANFD 的 UDS 诊断测试工具设计与实现
开发语言·python·测试工具
SomeOtherTime2 小时前
番外篇(第 12 讲):走向工业界深水区——从物理定律看 Rust 在真实工程中的“降维打击”与“阿喀琉斯之踵”
开发语言·rust
Kapaseker3 小时前
Rust 桌面开发到底怎么选?先看这篇文章!
rust
黑客笔记3 小时前
Python 进程池和线程池:用等待任务理解并发
开发语言·python
奶油话梅糖4 小时前
容器启停 2.5 毫秒:11 天 1,700 Star 的 Kiri,用一个 900 KB 的 PID 1 干掉了 runc 和 dockerd
前端·人工智能·rust
pps-key15 小时前
网络攻防入门:从“黑客梦”到合法实操(生存篇)
开发语言·web安全·php
汤姆宝库16 小时前
BPE分词器的完整实现:字节对合并与词表构建
开发语言·人工智能·c#