贴子渲染格式

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!

插入图片前先在工具条中按image按钮插入图片,得到该图片上传后的地址值,如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)。