鄙人在使用 Discourse 论坛发帖的过程中，发现关于帖文格式有一些值得留意、但常常被大家忽略的问题，这里鄙人简单总结一下，希望能给大家发帖提供帮助。
1 帖文中的网址/URL
1.1 概述
Discourse 论坛可以自动将帖文中的 URL 识别为超链接，不需要加入特殊的标记字符。但是，系统识别时容易出现一些错乱，如果 URL 和其后的文本之间不加空格分割，那么 URL 后的文本也会被识别为 URL 的内容，从而产生错误的超链接。
1.2 错误案例
这是一种不太合理的源代码写法：
https://www.appinn.com/是小众软件官网的链接。
渲染出的文本是
1.3 改进方案
根据 markdown 语法标准，文档中的 URL 应该用尖括号 < > 包裹。这样，系统就不会将 URL 外的文本与 URL 混在一起啦。
<https://www.appinn.com/>是小众软件官网的链接。
渲染出的文本是
https://www.appinn.com/是小众软件官网的链接。
1.4 附：Onebox
Discourse 论坛还有一个功能叫 Onebox，即将 URL 显示为一个卡片，卡片中会显示目标网页的标题、缩略图、内容摘要等信息。在帖子中生成 Onebox 的方式也很简单，将 URL 作为单独的一行插入帖子即可，注意上下各空一行。比如：
dufs 在 Github 上的项目地址是：
https://github.com/sigoden/dufs
dufs 在 Github 上的项目地址是：
但需要注意的是：
- 一些网站不允许爬取其数据，这样的网站无法展示 Onebox。
- 有时候，由于网络问题，论坛系统无法获取 URL 目标网页的信息，这时也无法显示 Onebox，该 URL 会显示为一个普通的超链接。
- 将 bilibili、YouTube 等视频网站的 URL 按 Onebox 的格式插入帖文，则会显示为内嵌的播放器。
- 首次在帖子中插入 Onebox，会获得论坛的 “首个 Onebox” 徽章一枚哦！
2 带扩展名的文件名
2.1 概述
有时候，帖文中带有扩展名的文件名也会被系统识别为 URL ，从而错误地为其加上超链接。对于这种情况，个人建议用反引号包裹文件名，比如
"记事本" 的可执行文件是 `C:\Windows\` 目录下的 `notepad.exe`。
渲染出的文本是：
“记事本” 的可执行文件是
C:\Windows\目录下的notepad.exe。
2.2 “反引号” 在哪儿？
对于一般的 PC 键盘，反引号在键盘左上角，Esc 键之下、Tab 键之上、1 键左侧。
3 特殊符号（主要是星号 *）
3.1 概述
Discourse 论坛使用的是 markdown 标记语言，其中有些特殊符号是系统预留的，主要是如下符号：
- 星号
* - 反引号
- 大于、小于号
>、< - 美元符号
$
它们在帖子中有特殊的含义，直接插入到帖文中可能不会显示出来。比如
- 夹在两个星号之间的内容，会被渲染为斜体。比如
*awsl*→ awsl - 夹在两个反引号之间的内容，会作为代码块，以等宽字体显示，文本背景为浅灰色。
- 用尖括号（其实就是大于、小于号）包裹的内容，会被渲染为超链接。
- 夹在两个美元符号之间的内容，会被渲染为 LaTeX 数学公式。比如
$\int_0^\infty f(x)$→ \int_0^\infty f(x)
3.2 解决方案
如要在帖子中显示这些特殊符号，有如下两种方法：
- （个人比较推荐）用反斜杠
\进行转义。比如\*awsl\*→ *awsl* - 用反引号包裹，作为代码块显示（但对反引号不起作用）。
但我发现，其实一般来说在帖子中单独输入 $、<、> 不会出现被错误渲染的情况，但保险起见，还是建议您加上反斜杠转义一下。
4 “我最喜爱” 频道中的帖子
“我最喜爱” 频道在这里：
很多朋友在发帖时没有注意到这个频道中帖子的特殊性，因此经常能看到不规范的回帖。这里简单介绍一下。
“我最喜爱” 频道的帖子都是投票帖，每一个回复都会作为一个提名项目参与投票，因此该频道发帖有些特殊要求：
- 每一条回复，只能提名 一个 软件或方案。如想提名多个软件或方案，请将其分为多个回帖发送。但需要注意的是本论坛似乎对一位用户的连续发帖数量有限制。
- 如果只想对某个提名项目，或对该帖子的内容进行评论，而不想提名软件或方案，请不要直接在帖子下面回复。用户可以在需要回复的帖子下面，点击 “添加评论” 进行讨论。
- 不要进行重复提名。
- 进行提名前，请仔细阅读一楼的发帖要求。有些投票帖会要求提名者提供详细的信息，如软件平台、是否收费等，也可能会规定发帖格式。为了方便他人浏览，请您尽量遵守。
插句题外话，提名安卓应用的时候，最好把软件包名也带上。因为应用重名的情况还是很多的，加上包名，用户下载后可以确认一下自己下载的软件和推荐的是否一样。
5 维基帖
一般而言，论坛中的帖子只有发帖人和版主/管理员可以进行编辑，但维基帖是所有用户均可参与编辑的。维基帖一般发布在 “网络黄页” 频道：
维基帖没有统一的格式规范，但大家参与编辑前，请务必仔细阅读楼主的格式要求，或观察其他人编辑后帖子的格式，保持版面的整洁、统一。
废话可能有点多，希望能给大家带来一些帮助。最后，祝大家新春快乐，龙年大吉……诶，今天是大年初五，可能有点晚了，不要紧，那就祝大家晚年幸福吧 o(*≧▽≦)ツ
