论坛发帖快速入门指南(Markdown 简易指南)

相信部分迷雾通论坛用户对于当今主流的国际软件交互方式并不习惯,该指南将会从容易出现错误的地方进行指导。

空格与段落

空格

Markdown 语法对行与空格都比较严格,当发送表情时,如果文字与表情代码之间没有有空格,那么渲染器就不会输出表情,例如下面的原始输入

演示文字:grinning:
演示文字 :grinning:

将会输出为

演示文字:grinning:
演示文字 :grinning:

如果发现渲染不正确,可以尝试对 Markdown 标记符号与文字之间添加空格。

段落

Markdown 对空白段落也有区别,比如下面的原始输入

第一行测试用文字段落,伴专清优复农多白绝藸像牙望队饭闻只场动?`发然同口胡术银鸟宝华又国帮广群背游?玛!是见跟拍什联汽群德?研罗怀流妇吃息兵族。称回痛块负管是终入巨题青野少古孤。验列!
第二行测试用文字段落,萨雄火类份交顺既丝。承更低穿度伊更容塞。将睡贵应应百视委商北熟点算倒背。森仅际!后药牙本已达冷答动气速误部尔不。追高您!班克经童公普道忽村字权品器哥德年!充夜!

第四行测试用文字段落,留皮助度害。脑我萨需电责阵妇研相罗美工!己鱼取不深呀行掉。院东当功就菜队忙量很!欧醒楼研也兴饭系坦外无毫离蒙束安。众胡?静莱母显付哭创迷名考竟院市店!奇读另公!

将会输出为

第一行测试用文字段落,伴专清优复农多白绝藸像牙望队饭闻只场动?`发然同口胡术银鸟宝华又国帮广群背游?玛!是见跟拍什联汽群德?研罗怀流妇吃息兵族。称回痛块负管是终入巨题青野少古孤。验列!
第二行测试用文字段落,萨雄火类份交顺既丝。承更低穿度伊更容塞。将睡贵应应百视委商北熟点算倒背。森仅际!后药牙本已达冷答动气速误部尔不。追高您!班克经童公普道忽村字权品器哥德年!充夜!

第四行测试用文字段落,留皮助度害。脑我萨需电责阵妇研相罗美工!己鱼取不深呀行掉。院东当功就菜队忙量很!欧醒楼研也兴饭系坦外无毫离蒙束安。众胡?静莱母显付哭创迷名考竟院市店!奇读另公!

如上面的测试文字段落所示,如果没有空白段落,就会紧贴着上一行文字,如果是很长的文字,可能就会带来阅读困难,造成排版灾难,本来很有价值的主题也会被排版所埋没。

链接

markdown 的链接使用两个括号进行定义,前面使用方括号,后面使用括弧,均为半宽的标点。

[标题](链接)

全文引用/onebox

Discourse 的 onebox 功能对引用的支持非常强大,只要把网站地址单独作为一行内容,就能生成一个块状的全文,如果是图片共享网站,那么会直接显示图片。

主流的视频、文章、图片分享网站都支持。

社交媒体发言 onebox

比如推特、任意 Discourse 论坛的某一楼层:

具体链接一般会在发送的时间上,手机长按就能复制,PC右键复制或者点击分享按钮获得这层楼的链接。

主流视频网站

直接发送一行 YouTube 的视频地址,就能让视频出现在自己的主题里。

https://www.youtube.com/watch?v=LXb3EKWsInQ

其他的世界主流视频网站,vimeo 也被支持。

地图

打开 Google 地图网页版,定位到某个位置,复制当前地址栏中的地址,你会得到一串很长的地址比如下面这样的

https://www.google.com/maps/place/人民英雄纪念碑/@39.9038052,116.3969655,18.08z/data=!{一串不可读内容}

这时只需要保留 data=! 之前的内容,就足够定位了,后面的代码应该是追踪用户用的,不建议附带上。

Google 地图的演示请看二楼 ↓


参考资料

  1. Rich link previews with Onebox - howto / faq - Discourse Meta

如果该指南有任何遗漏、错误,请帮忙指出,我一定虚心接受并改正。

我的PGP公钥 ECFAD774868C9AD1A7FD726C06A8C9E815B31245

2021-01-28T00:00:00Z

PGP对标题及简介的签名

论坛发帖问题疑难解答(Markdown 简易指南).txt

3 Likes

上面主题的 Google 地图可能因为某些限制,导致没有成功触发 onebox,这里重新演示一次。

1 Like