论坛怎么发长文？Markdown 语法与全文阅读模式

在 Clara BBS 里发长文，靠的是三样东西：**Markdown 轻语法负责排版、图片/附件负责承载素材、全文阅读模式负责让读者读得下去**。三者配合，一篇几千字的技术长帖也能排得像模像样，不用装任何编辑器插件。

Markdown 轻语法：长文排版的主力工具

结论：Clara BBS 的发帖框原生支持 Markdown 轻语法，长文靠它分结构就够了，不需要背完整语法表。

日常写长帖真正高频的只有几个符号，记住这一组基本能覆盖 90% 的排版需求：

• `## 标题` / `### 小标题`：长文最重要的就是分节，读者靠小标题跳读
• `加粗`：强调关键结论
• `- 列表` / `1. 列表`：步骤、参数清单
• `> 引用`：贴需求原文、错误日志、别人说的话
• `` `代码` `` 与三个反引号代码块：命令、配置、报错信息必须走代码块，不然容易被论坛自动换行打乱
• `[文字](链接)`：外链

注意点：Markdown 里的空行是「分段符」，不是装饰。段落之间必须空一行，否则会被当成同一段挤在一起——这是新手写长文最常见的翻车点。另外表格这类复杂结构在轻语法下支持有限，参数对比建议直接用列表写，反而更耐看。

全文阅读模式：长帖的阅读体验开关

结论：全文阅读模式是 Clara BBS 为长文准备的专门视图，自带目录与阅读进度条，把一篇几千字的帖子变成可导航的文档。

它的价值在于解决了论坛长帖的两个老大难：

1. 目录跳转——读者不必一路滚到底找某一节，点目录直接跳；
2. 进度条——读者知道「还剩多少」，不容易中途弃读。

对作者来说，这意味着你可以放心把文章写长。写法上有个配合技巧：小标题层级尽量规整（统一用 `##` 做节、`###` 做子节），目录生成出来才整齐好看；标题乱用层级，目录就会显得很乱。

长文折叠：先给目录，再给正文

结论：Clara BBS 支持长文折叠，适合超长教程、系列合集、附大量代码的帖子。

折叠的意义是控制首屏长度——读者先看到结构，愿意深入再展开。适合折叠的内容包括：完整代码清单、附录、更新日志、超长参数表。正文的核心结论和步骤不要折叠，那是读者最需要第一眼看到的东西。

素材承载：图片、附件、投票怎么配

结论：长文不只是文字，Clara BBS 的图片上传、附件（可定价出售）、投票（2-20 选项）都能直接挂在帖子里。

• 图片上传：属于会员专属权益，普通用户需要开通含「图片上传」权益的会员套餐；管理员豁免。上传失败按三步排查——后台「系统设置→上传」的「允许的扩展名」是否含该格式、PHP 的 `upload_max_filesize`/`post_max_size` 是否大于文件体积（宝塔默认 2M，手机照片常超，建议调到 30M+）、`uploads` 目录是否可写。
• 附件：发帖时附件面板可设价格与货币（0 = 免费），还能限定下载权限（所有人/会员/指定用户组）；文件大或不想占服务器存储，可以用网盘链接模式，填链接 + 提取码即可。
• 全文出售：如果长文本身要收费，可开启全文出售，未购读者能读前 300 字预览，购买款全额归作者。

长文发帖的几个实操建议

结论：结构先行、小标题规整、首屏放结论，是 Clara BBS 上长文能被读完的三条硬规则。

1. 开头 3 行内说清「这篇讲什么、能解决什么问题」；
2. 每节第一句先给结论，再展开，方便跳读；
3. 代码、命令、参数一律用代码块，避免被自动格式化；
4. 段间空行，别写成一坨；
5. 超长部分用折叠，附录类内容往下压。

最后提醒一个常见报错：发帖时提示「页面已过期，请刷新后重试」，是 CSRF 校验没通过，通常因为页面缓存太久或登录态变了。新版编辑器已内置自动重试（拉新 token 重发一次），仍出现就刷新页面；同时建议后台「基本设置」里的站点地址填对（带 `https://` 与主域名），避免 www 和裸域混用导致会话丢失——长文写一半被这个卡住，最亏。