Markdown 语法入门基础教程
Markdown 语法入门基础教程 - iKxin小站

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列表代码无效，请于第一行前回车（第一行换行）即可。

[hl]附上Flarum支持的BBcode[/hl]

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]
tab &emsp;
空格 &nbsp;

苏ICP备18041234号-1 苏公网安备 32021402001397号