Bitbucket中CHANGELOG.md嵌套列表Markdown渲染异常求助
问题原因与解决方案
不同Markdown平台的解析器对嵌套列表的缩进要求存在细节差异,这就是你遇到的问题根源:
- GitHub、VS Code、Stack Overflow使用的解析器(多基于GFM或CommonMark规范)支持2空格缩进识别嵌套子列表;
- Bitbucket的解析器采用了更严格的缩进规则,要求至少4空格才能将列表项识别为上一级列表的子项,所以2空格缩进会被解析成独立的顶级列表,导致渲染异常。
兼容多平台的写法
如果要让CHANGELOG在所有平台都正常渲染嵌套列表,统一使用4空格缩进子列表即可:
## 🐛 Bug Fixes - `commithash` enable main automatic pipeline - Author: committer - Date: 01/08/2024 20:15:08
这种写法在GitHub、VS Code、Stack Overflow和Bitbucket中都能正确呈现嵌套效果。
内容的提问来源于stack exchange,提问作者BugsOverflow
相关产品推荐
相关产品推荐

