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]