Markdown 语法是 Flarum 主推的内容输入方案(另外还有bbcode,下面也会讲到),以下简单介绍Markdown 的使用方法,本文主要是写给Flarum的新手们,帮助小白迅速成为大佬。

标题

标题是每篇文章都需要也是最常用的格式,在 Markdown 中,如果一段文字被定义为标题,只要在这段文字前加 # 号即可。注:“#”和标题之间有一个空格。以此类推,总共六级标题(H1 到 H6,#号后必须加空格),不过flarum 只支持 其中的 H1到 H3,也就是你最多只能打三个“#”号。

# 一级标题
## 二级标题
### 三级标题

列表

熟悉 HTML 的同学肯定知道有序列表与无序列表的区别,在 Markdown 下,列表的显示只需要在文字前加上 - 或 * 即可变为无序列表,有序列表则直接在文字前加1. 2. 3. 符号要和文字之间加上一个字符的空格。

无序列表

- 1
- 2
- 3

有序列表

1. a
2. b
3. c

多层序列

- 嵌套列表
 + 嵌套列表
 + 嵌套列表
     - 嵌套列表
         * 嵌套列表
- 嵌套列表

引用

如果你需要引用一小段别处的句子,那么就要用引用的格式。只需要在文本前加入 > 这种尖括号(大于号)即可。

> 例如这样

图片与链接

插入链接与插入图片的语法很像,区别在一个 !号,中括号为链接文本(图片可以不写)括号为连接地址:

添加链接

[Notte博客](https://www.ikxin.com/)

高级链接

带提示标题的链接

[鼠标移上来](https://www.google.com "Google 首页")

引用链接(引用内容不限,可以任意字符,甚至可以写数字)

[引用式链接][Notte博客]
[Notte博客]: https://www.ikxin.com/

内置链接

[内部文件](../blob/master/LICENSE)

添加图片

![图片介绍](https://img.8b5.cn/2018/07/26/5b5957facadf4.png)

免费图库推荐 sm.ms

该图库支持生成Markdown语法链接

高级图片

带描述图片

![alt text](https://img.8b5.cn/2018/07/26/5b5957facadf4.png "Logo 文本")

引用式连接

![alt text][logo]
[logo]: https://img.8b5.cn/2018/07/26/5b5957facadf4.png "Logo 文本"

粗体、斜体、删除线

Markdown 的粗体和斜体也非常简单,用两个星号包含一段文本就是粗体的语法,用一个星号 包含一段文本就是斜体的语法。

 **这里是粗体**
 *这里是斜体*
 ~~这里是删除线~~

脚注

用于特殊标注,空格作为结束

二月十四号^情人节 这天

代码框

如果你是个程序猿,需要在文章里优雅的引用代码框,在 Markdown下实现也非常简单,只需要用`号把中间的代码包裹起来。写法分两种

1、单个或两个`号代表内联文本

分别是 `蔬菜` 和 ``水果`` 

2、三个`号并回车包裹中间代码,就跟 bbcode 的 code 用法一致了(偷懒的话也可以按四个空格来实现)


分隔符

在一行中用三个以上的星号(*)、减号(-)、下划线(_) 来建立一个分隔线。

***
---
___

提示:如果发现Markdown列表代码无效,请于第一行前回车(第一行换行)即可。


附上Flarum支持的BBcode

1、加粗:[b]bold[/b]

2、斜体:[i]italic[/i]

3、下划线:[u]underline[/u]

4、删除线:[s]strike[/s]

5、链接:[url=http://www.xfum.org/]链接[/url]

6、语法高亮:[code lang=php]<?php phpinfo(); ?>[/code]

7、字体颜色:[color=red]红色[/color]或者[color=#ff0000]红色[/color]

8、字体大小:[size=10]10字号[/size]

9、居中对齐:[center]居中内容[/center]

10、隐藏内容:[details=点击查看]隐藏内容[/details]

11、音频:[audio]https://awk.tw/audio/How.to.pronounce.Vivaldi.mp3[/audio]

12、视频:[video]https://awk.tw/video/opera_new.mp4[/video]

另外还支持[img]、[list]等,因为Markdown已提供更好的实现方案,所以不推荐用bbcode。

13、列表:

[LIST]
[*]Bullet 1
[*]Bullet 2
[/LIST]
[LIST=1]
[*]Entry 1
[*]Entry 2
[/LIST]

14、高亮内容(dev 0.6.2新增)

代码:[hl]高亮内容[/hl]

如果觉得我的文章对你有用,请随意赞赏