Markdown
常用Markdown语法:
- 标题:使用
#
来创建标题,例如# 一级标题
、## 二级标题
。
- 加粗:使用两个星号
**文字**
来加粗文字。
- 斜体:使用一个星号
*文字*
来斜体文字。
- 链接:使用
[链接文字](URL)
来插入链接。
- 图片:使用
![alt|宽度*高度](URI)
来插入图片。
- 列表:使用
-
或*
来创建无序列表,使用数字加.
来创建有序列表。
- 代码块:使用三个反引号```来创建代码块,也可以指定语言进行语法高亮。
- 行内代码 使用一个反引号`来创建行内代码。
BBcode
Discourse支持的BBCode语法:
- 加粗:
[b]文字[/b]
- 斜体:
[i]文字[/i]
- 下划线:
[u]文字[/u]
- 删除线:
[s]文字[/s]
- 链接:
[url=链接URL]链接文字[/url]
- 图片:
[img]图片URL[/img]
- 引用:
[quote]引用内容[/quote]
- 代码:
[code]代码[/code]
- 邮件:
[email]邮件地址[/email]
HTML
论坛有一个标签列表,只有支持的标签和属性才会被解析渲染。
支持的标签属性列表
当插入的标签或属性不在列表里,将失效。
举个栗子🌰
居中文本
<div align="center">
<h1>BBcode</h1>
</div>
LaTeX 数学公式
Discourse 能够渲染 LaTeX 公式。公式有两种:
-
行内公式 (inline math),如: a^2+b^2=c^2 。数学公式用一对$
来包围,同时在第一个$
之前,第二个$
这后都应留出一个空格。前面行间公式的输入格式为:
$a^2+b^2=c^2$
-
行间公式 (display math),行间公式用一对$$
包围,如:
$$
e^{i \pi} + 1 = 0 \label{1}\tag{1}
$$
渲染为:
e^{i \pi} + 1 = 0 \label{1}\tag{1}
可以用$\eqref{tag}$
的方式引用方程,如引用方式程 \eqref{1} 。
HTML语法
HTML语法可以极大提升帖文的阅读体验。下面是针对各类场景的具体介绍。
图片居中
dest is here!
插入图片前先在工具条中按按钮插入图片,得到该图片上传后的地址值,如upload://zv7CFjknxj8H2dnAbgZ5hmnb6k1.jpeg
。然后按HTML语法写到src
中,如:
<div align="center">
<img src="upload://zv7CFjknxj8H2dnAbgZ5hmnb6k1.jpeg" width="500" />
</div>
显示出下图:
锚点
锚点是实现网页内跳转的方法。体验一下: go here!
锚点格式:
<a name="dest"> dest is here! </a>`
引用格式:
<a href="#dest"> go here! </a>
键盘输入
请按 <kbd>Ctrl</kbd> + <kbd>C</kbd> 来复制文本(Windows)。
请按 Ctrl + C 来复制文本(Windows)。