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

发布于 2020-05-21 14:49:13

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

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

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://fa.rt-thread.org)

显示效果
RT-Thread交流社区

4. 图片

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

示例代码

 ![logo.jpg](/uploads/20200521/bd386ed9c70c3329ee4c452d824ebdb0.jpg)

显示效果

logo.jpg

5. 引用

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

示例代码

> RT-Thread是一个嵌入式实时多线程操作系统,系统完全开源,它不仅仅是一个实时内核,还具备丰富的中间层组件,包括如文件系统、图形库等较为完整的中间件组件,具备低功耗、安全、通信协议支持和云端连接能力的软件平台,RT-Thread 就是一个 IoT OS。

显示效果

RT-Thread是一个嵌入式实时多线程操作系统,系统完全开源,它不仅仅是一个实时内核,还具备丰富的中间层组件,包括如文件系统、图形库等较为完整的中间件组件,具备低功耗、安全、通信协议支持和云端连接能力的软件平台,RT-Thread 就是一个 IoT OS。

6. 粗体和斜体

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

示例代码

**粗体**
*斜体*

显示效果
粗体
斜体

7. 代码

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

示例代码

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

显示效果

printf("hello,rt-thread")

8. 表格

对于表格类,我们的建议是在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 条评论

发布
问题

0.118184s