近期巡查发现,站内大量主题图文存在拆分问题,楼主常将正文配图、关键图片内容分散放置在回复楼层中,仅在主楼留存少量文字。
理解大家希望精简主楼界面、拆分长篇内容、提升浏览整洁度的排版需求。但此类发布方式,会严重影响站点内容的搜索引擎收录机制。搜索引擎主要抓取主楼核心内容,回复区图文权重极低,会直接造成图片及拆分文本无法被正常检索收录,甚至出现整篇内容收录失效的情况,大幅削减优质内容的对外曝光与传播效果。
同时,图文分离、内容碎片化,也会让访客无法在主题首页一站式查看完整内容,需要逐层翻阅回复查找图片资料,严重影响阅读体验,不利于优质内容沉淀与长期留存。
在此提醒各位作者:请将主题全部文字、配套图片统一整合至主楼完整发布。若内容篇幅较长,可合理分段排版、有序编辑,切勿把核心配图、关键内容拆分到后续回复当中。
规范统一的发布格式,既能有效保障内容正常收录、提升流量曝光,也能优化论坛整体阅读环境,共建规整、优质的社区内容生态。
[!tip]
下面是推荐排版做法,内容采用了AI润色,我已经审查,有问题可以直接wiki编辑(已开启)
1. 基础排版
- 标题:用
#、##、###(一级到三级标题) - 段落:空一行自动分段
- 粗体/斜体:
**粗体**、*斜体* - 列表:
-或1.(无序/有序) - 引用:
> 引用内容 - 代码:单行用
`代码`,多行用``` - 折叠内容:
[details=点击展开图片合集] 这里放图片 [/details]
2. 图片基础
-
Markdown:
 -
调整大小:
|690x395→ 固定宽高- 只写宽度:
|500x(高度自动按比例) - 百分比缩放:

-
其他方式:
- HTML:
<div align="center">包裹可居中。
- HTML:
3. 大量图片排版
Discourse 有内置 图片网格(Grid) 和 轮播(Carousel) 功能,专门为多图帖子设计,效果远超普通 Markdown。
(1)图片网格 Grid(推荐)
把多张图片用 [grid] 标签包裹,自动排成整齐网格(桌面 3 列,手机 2 列,4 张图自动 2 列):
[grid]



[/grid]
- 效果:自动平衡列高,图片顶对齐+底对齐,布局美观不乱。
- 编辑器里会出现小开关图标,可以一键开启/关闭网格预览。
- 适合 3~20 张图片对比、产品图集、教程步骤等。
(2)轮播模式 Carousel(论坛新功能,更适合很多图)
在 grid 标签里加 mode="carousel":
[grid mode="carousel"]


[/grid]
- 效果:横向滑动轮播,图片居中显示,不会把关键部分裁掉。
- 手机支持左右滑动,适合 10 张以上大图展示。
- 在富文本编辑器(RTE)里也可以直接点右上角切换「Carousel」模式。
使用技巧:
- 图片数量 ≥2 张就能自动触发网格/轮播。
- 如果图片有文字说明,建议把说明放在 grid 外面,否则可能被吃掉。
- 想让图片可点击跳转:
[](跳转链接)
4. 进阶技巧
- 居中单张图片:
<div align="center">
<img src="链接" alt="描述" width="500">
</div>
- 图文混排:先写文字,再插入图片,Discourse 会自动流式排版。
- 太多图片时:用
[details]折叠,或分多个 grid 块。 - 性能优化:上传前把图片压缩到 10MB 以下,Discourse 会自动生成缩略图,加载更快。
5. 编辑器小功能
- 工具栏有「上传图片」按钮。
- 富文本模式下可以直接选中图片 → 调整大小/对齐。
- 预览模式下点图片旁边的开关就能切换 Grid / Carousel。
6. Alert提示
还有alert 提示组件:
- 使用语法(超级简单,和写普通引用一样):
> [!note]
> 这里是 NOTE 提示内容,可以多行,支持 Markdown、图片、列表等。
常用类型(支持这些,大小写不敏感):
| 类型 | 效果描述 | 别名(可以直接用) | 示例语法 |
|---|---|---|---|
note |
普通备注/信息 | - | [!note] |
tip |
提示/重要信息 | important、hint |
[!important] |
warning |
警告 | caution、attention |
[!warning] |
danger / error |
危险/错误 | - | [!danger] |
success |
成功/完成 | check、done |
[!success] |
info |
信息 | - | [!info] |
question |
问题/FAQ | help、faq |
[!question] |
todo |
待办事项 | - | [!todo] |
进阶用法(实用):
- 带自定义标题:
> [!tip] **重要提醒**
> 记得先备份数据!
[!tip] 重要提醒
记得先备份数据!
- 可折叠(+ 展开 / - 折叠):
> [!todo]- 折叠的待办
> - [ ] 任务1
> - [x] 任务2
[!todo]- 折叠的待办
- 任务1
- 任务2
- 仅标题(简洁版):
> [!success] 已解决
[!success] 已解决
- 支持嵌套、富文本编辑器里直接输入
/callout:tip或!!tip快速插入。



