Mr.C

开始使用论坛时，应该细心的小伙伴们就发现了，我们虽然用的是Discuz老版本的论坛程序。

但是没有编辑器，那么，没有编辑器，就只能文字书写了吗？

其实不是的，我们是屏蔽了Discuz默认的BBcode，改用了Markdown书写格式

## 那么，什么是Markdown？

Markdown格式是John Gruber于2004年创造的， Markdown 的目标是实现“易读易写”。 Markdown定义了一种简单好用的文本文件格式， 作为单独的文本文件， 此格式没有什么多余的标签， 又可以转化为很多其它的格式。

Markdown 的语法全由一些符号所组成， 这些符号经过精挑细选，其作用一目了然。 比如：在文字两旁加上星号，看起来就像强调。 Markdown 的列表看起来就像我们平常在邮件中写一个列表的方法。 Markdown 的区块引用看起来就真的像是引用一段文字， 就像你曾在电子邮件中见过的那样。

需要时， 可以直接在markdown中写HTML标记内容。 markdown能实现的功能是HTML的一部分， 但是比HTML内容更干净， 没有掺杂过多的与要表达的意思无关的标签。 Markdown的理念是，能让文档更容易读、写和随意改。

**Markdown 语法的目标是：成为一种适用于网络的书写语言。**

Markdown 不是想要取代 HTML，甚至也没有要和它相近，它的语法种类很少，只对应 HTML 标记的一小部分。Markdown 的构想不是要使得 HTML 文档更容易书写。在我看来， HTML 已经很容易写了。

Markdown 的理念是，能让文档更容易读、写和随意改。HTML 是一种发布的格式，Markdown 是一种书写的格式。就这样，Markdown 的格式语法只涵盖纯文本可以涵盖的范围。

> 总结一下，那就是，即便不解析markdown格式了，所有的帖子依然具备相当强的阅读性。
>
>而Markdwon这个优点，是html标签，bbcode均不具备的。
>
>可能我这样说，没有什么说服力，来让我们看看图片
>
>
>
>所以，大家看完了这个，相信也知道MarkDown格式相对于以前的各种书写格式有着非常强的优势。
>
>这也是为啥我从建站开始就一直坚持使用Markdown的原因

好了废话不多说了，大家看教程吧。

Mr.C

>Markdown的书写格式，稍微区别于普通的文本格式，希望诸君能耐心看完这篇小教程 😃

普通的书写格式，一次回车换行即可。

例如
```
白日依山尽，黄河入海流。
欲穷千里目，更上一层楼。
```
但是markdown会显示为


白日依山尽，黄河入海流。
欲穷千里目，更上一层楼。

---------------------

如果想换行， 输入时要`回车两次`。例如：
```
白日依山尽，黄河入海流。

欲穷千里目，更上一层楼。
```
显示结果为：

白日依山尽，黄河入海流。

欲穷千里目，更上一层楼。

---------------

>这里举个小例子大家就明白为什么这样做了。

打个比方

以下是新闻稿件

>北京时间3月12日凌晨4点，22/23赛季法甲联赛第27轮继续。
>在弗朗西斯勒布雷球场，巴黎圣日耳曼客场2-1绝杀布雷斯特，多赛一场以11分的优势领跑。
>索莱尔首开纪录，霍诺拉特扳平比分，梅西助攻姆巴佩绝杀，并斩获俱乐部生涯第300次助攻。

这是编辑器中你书写的格式


这样一来，我们可以利用编辑器的单行回行，将一长段的文字拆分开编辑，并且保持发布后不改变这个长段，更利于写作。

------------

此外，对于目前大多数人的阅读习惯。

过长的文字已经不具备可读性了，所以大家灵活运用吧 😁

Mr.C

## 加粗
格式为`**需要加粗的文字**`

显示为

**需要加粗的文字**
## 斜体字
格式为`*需要斜体的文字*`

显示为

*需要斜体的文字*

## 那斜体加粗呢？
格式为`***需要斜体加粗的文字***`

显示为

***需要斜体加粗的文字***

## 删除线
格式为`~~需要删除线的文字~~`

显示为

~~需要删除线的文字~~

## 分割线
格式为`----------------------`

显示为

这是分割线

-------------------------------

这是分割线

Mr.C

可以用类似Email的回复包含原始邮件内容的办法输入引用段落， 即，在段落的每行前面加一个大于号。 比如下面的诗：
```
> 白日依山尽，黄河入海流。
> 欲穷千里目，更上一层楼。
```
转换成

> 白日依山尽，黄河入海流。
> 欲穷千里目，更上一层楼。

注意引用也是段落模式，内容中的换行不起作用，空行导致分段。

引用段落也可以仅在段落第一行写大于号， 其它行顶格写，例如下面的两段引用：

```
> 远上寒山石径斜，
白云生处有人家。
>
> 停车坐爱枫林晚，
霜叶红于二月花。
```
显示为

> 远上寒山石径斜，
白云生处有人家。
>
> 停车坐爱枫林晚，
霜叶红于二月花。

引用也可以嵌套，如：
```
> 张三说：李四这样说过
>
>> 不想当将军的木匠不是好厨子。
>
```
显示为

> 张三说：李四这样说过
>
>> 不想当将军的木匠不是好厨子。
>

Mr.C

示例：
```
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
```
显示为

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

Mr.C

贴内图片，其格式为
```
```
显示为

Mr.C

在markdown里制作表格也非常简单，看下面的源码

```
表头|表头2|表头3
--|--|--
内容|内容2|内容3
内容|内容2|内容3
内容|内容2|内容3
内容|内容2|内容3
```
显示为

表头|表头2|表头3
--|--|--
内容|内容2|内容3
内容|内容2|内容3
内容|内容2|内容3
内容|内容2|内容3

## 表格内换行

可以用`<br>`表示换行。

举例
```
Name|Lucky Number
--|--
Leslie|2<br>7
Mike|3<br>5<br>8
```
显示为

Name|Lucky Number
--|--
Leslie|2<br>7
Mike|3<br>5<br>8

Mr.C

代码块是使用上下三个连续的“ **`** ”符号来表达


显示为
```
function getage(age){
    return age
}
```
## 文字内的代码呢？
```
文字内的代码是使用`这里是代码`来显示
```

显示为

文字内的代码是使用`这里是代码`来显示

Mr.C

## 有序列表
有序列表:使用数字进行标号

```
考试排名:
1. 小红
2. 小陈
3. 小李
```
显示为

考试排名:
1. 小红
2. 小陈
3. 小李

## 无序列表
使用符号+ - *任意一个都可以。

注意：不能混用。自动划分，不同符号创建的列表
```
+ 水果
+ 香蕉
+  桃子
+ 苹果
- 水果
- 香蕉
-  桃子
- 苹果
* 水果
* 香蕉
*  桃子
* 苹果
```
显示为

+ 水果
+ 香蕉
+  桃子
+ 苹果
- 水果
- 香蕉
-  桃子
- 苹果
* 水果
* 香蕉
*  桃子
* 苹果

Mr.C

行内式
格式为：
```
[链接文字](地址)
```
例如：
```
[百度首页](https://www.baidu.com/)
```
效果如下：

[百度首页](https://www.baidu.com/)

## 参考式
参考式超链接一般用在学术论文上，或者某个链接在文章中多处被引用的情况，这样便于对链接统一管理。

参考式链接的写法相当于把行内式拆分成两部分，并通过一个链接标记来连接两部分。

语法说明：

参考式链接分为两部分：首先写
```
[链接文字][链接标记]
```
然后在文本的任意位置写
```
[链接标记]:地址 "标题"
```
例如：
```
我经常去的几个网站是[GitHub][1]，[知乎][2]，[简书][3]。

[1]:https://github.com "github.com"
[2]:https://www.zhihu.com "zhihu.com"
[3]:http://www.jianshu.com "jianshu.com"
```

显示为

我经常去的几个网站是[GitHub][1]，[知乎][2]，[简书][3]。

[1]:https://github.com "github.com"
[2]:https://www.zhihu.com "zhihu.com"
[3]:http://www.jianshu.com "jianshu.com"