RT-Thread交流社区中发贴的Markdown语法介绍

发布于 2020-07-02 10:57:04

RT-Thread交流社区作为一个开发者的交流探讨的聚集地,对 Markdown 的支持是必不可少的,在这里介绍下Markdown在发贴时的用法,大家掌握以下其中写法就够用了。

  1. 标题
  2. 列表
  3. 链接
  4. 图片
  5. 引用
  6. 粗体和斜体
  7. 表格

1. 标题

在发贴中经常用到, Markdown 支持6种标题,我们可以使用# 前缀来标记,注意# 后面有个空格

示例代码

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

显示效果

2. 列表

markdown中,可以使用 + - *1. 来标记无序列表和有序列表,注意- 1. 后面有个空格

示例代码

- RT-Thread官网
- RT-Thread社区
- RT-Thread文档
1. RT-Thread官网
2. RT-Thread社区
3. RT-Thread文档

显示效果

  • RT-Thread官网
  • RT-Thread社区
  • RT-Thread文档
  1. RT-Thread官网
  2. RT-Thread社区
  3. RT-Thread文档

3. 链接

在发贴时插入链接是我们经常需要使用到的一个操作,虽然在RT-Thread可以直接粘贴链接,在这里还是做一下简单介绍
链接的语法比较简单,使用[显示文本](链接URL)

示例代码

[RT-Thread交流社区](https://club.rt-thread.org)

显示效果
RT-Thread交流社区

4. 图片

在发贴时图片是我们经常需要用到的,虽然在RT-Thread可以直接粘贴上传并生成markdown链接格式,但这里还是做一下简单介绍
图片的语法只是在链接的语法前多了一个!,使用![图片描述](图片地址)

图片建议上传本站,会自动生成代码,然后剪切到对应的位置即可。

不建议引用图床图片。以免图片丢失,内容不可见。

示例代码

![rt-threadlogo]( uploads/20200703/41363d54db96c0ee7bf92ace9785bf5b.png )

显示效果

rtt_logo.png

5. 引用

在发贴时如果需要引用文字,可以使用> 来标记

示例代码

>RT-Thread 是一个集实时操作系统(RTOS)内核、中间件组件和开发者社区于一体的技术平台,由熊谱翔先生带领并集合开源社区力量开发而成,RT-Thread 也是一个组件完整丰富、高度可伸缩、简易开发、超低功耗、高安全性的物联网操作系统。RT-Thread 具备一个 IoT OS 平台所需的所有关键组件,例如GUI、网络协议栈、安全传输、低功耗组件等等。经过11年的累积发展,RT-Thread 已经拥有一个国内最大的嵌入式开源社区,同时被广泛应用于能源、车载、医疗、消费电子等多个行业,累积装机量超过 6亿 台,成为国人自主开发、国内最成熟稳定和装机量最大的开源 RTOS。

显示效果

RT-Thread 是一个集实时操作系统(RTOS)内核、中间件组件和开发者社区于一体的技术平台,由熊谱翔先生带领并集合开源社区力量开发而成,RT-Thread 也是一个组件完整丰富、高度可伸缩、简易开发、超低功耗、高安全性的物联网操作系统。RT-Thread 具备一个 IoT OS 平台所需的所有关键组件,例如GUI、网络协议栈、安全传输、低功耗组件等等。经过11年的累积发展,RT-Thread 已经拥有一个国内最大的嵌入式开源社区,同时被广泛应用于能源、车载、医疗、消费电子等多个行业,累积装机量超过 6亿 台,成为国人自主开发、国内最成熟稳定和装机量最大的开源 RTOS。

粗体和斜体

markdown中,粗体和斜体分别使用***来标记

示例代码

**粗体**
*斜体*

显示效果
粗体
斜体

代码

在发贴时我们经常需要贴代码,在markdown中单行代码可以使用代码来标记,多行代码可以使用来标记,注意在后面可以使用php/js/css等语言名称

示例代码

```c
printf("hello,rt-thread")
```

显示效果

printf("hello,rt-thread")

表格

对于表格类,我们的建议是在typora 中做好,然后直接复制过来,这样比较方便,下面也给出表格的具体书写形式。

示例代码

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

显示效果

标题1标题2标题3
内容1内容2内容3
内容1内容2内容3
内容1内容2内容3
1 条评论

发布
问题

分享
好友