issue: A Markdown file preview shows the content of a collapsible section outside it

问题场景

用户在 Open WebUI 中通过 Git Clone 安装并运行 dev 分支（f5a26f53a），在 Linux + Firefox 环境下使用。操作路径为 Workspace > Knowledge，打开或新建一个知识库，上传一个名为 notes.md 的 Markdown 文件，然后在文件列表中点击该文件并选择 Preview 进行预览。

该 Markdown 文件同时包含一个 <details>/<summary> 折叠块和一个 <div align="center"> 居中块。预览时折叠块标题“Click to open”展开后为空，隐藏内容“Hidden marker text”一直显示在折叠块下方，居中的“Centered title”则靠左显示。

报错原文

issue: A Markdown file preview shows the content of a collapsible section outside it

When a Markdown file is previewed in a knowledge base, a collapsible section shows up empty and its content is always visible below it.
A centered block, as many GitHub READMEs use for their title, is shown on the left instead.

"Click to open" is an empty collapsible section, and "Hidden marker text" is shown below it all the time.
"Centered title" is on the left.

No errors in the browser console. Default settings.

原因分析

根据 Issue 正文的 Additional Information，最可能的原因是：当前预览改为“逐块（block by block）渲染” Markdown 文件，而一个空行会终止一个 HTML 块。因此，开头的 <details> 或 <div> 标签，与它后面隔着空行的内容及闭合标签被拆成了不同的渲染块，导致折叠结构与居中属性无法正确应用。

Issue 还指出，最新 Release 版本会一次性绘制整个文件，从而让这些标签与内容保持在一起；也就是说，这可能是 dev 分支上分块渲染逻辑带来的回归。浏览器控制台无报错、使用默认设置，进一步说明这不是 JS 异常或配置问题，而是解析/渲染层面的问题。

环境排查

• 确认 Open WebUI 版本：是否为 dev 分支 f5a26f53a（问题在此版本确认复现）。
• 确认安装方式：Git Clone。
• 确认操作系统：Linux。
• 确认浏览器：Firefox。
• 确认 Ollama 版本：v0.40.5。
• 确认是否使用默认设置（Issue 中为默认设置，无自定义配置）。
• 确认浏览器控制台是否报错（Issue 中无报错）。
• 如对比排查，可核对最新 Release 版本行为是否正常，用于判断是否为 dev 分支的回归。

解决步骤

1. 先按 Issue 的最小复现步骤确认问题：将包含 <details> 和 <div align="center"> 的示例内容保存为 notes.md。
2. 进入 Workspace > Knowledge，打开或新建知识库并上传 notes.md。
3. 在文件列表点击 notes.md，选择 Preview，观察折叠块内容是否外露、居中是否失效。
4. 若确认复现，记录当前版本号（如 dev f5a26f53a）与安装方式，便于对照后续修复。
5. 可优先尝试切换到最新 Release 版本验证是否恢复正常（Issue 说明 Release 会一次性渲染整个文件），但该做法未在 Issue 中确认，仅作临时绕过。
6. 关注该问题被转入的 #32515 的修复进展，不要在散落 Issue 中重复提交。

验证方法

重新预览同一份 notes.md：折叠块“Click to open”在未点击时其内容“Hidden marker text”不可见，点击标题后才显示；同时“Centered title”恢复居中显示，而非靠左。若切换版本后表现与上述一致，说明问题已缓解或修复。

参考来源

open-webui/open-webui #32514

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。