分割线正确写法是独占一行的三个及以上连续-、*或_,兼容所有主流平台;推荐“空行+分割线+空行”结构提升可读性;禁用空格、文字混排及中文符号。

要在 Markdown 文档中清晰划分内容区块、提升可读性,必须掌握分割线的正确写法——它不是靠空行或手动加横线,而是依赖特定符号组合触发渲染引擎识别。
基础三符号分割线(通用兼容)
在任意独立一行中输入三个及以上连续的 -、* 或 _,前后不能有其他字符,该行即被识别为分割线。
---
***
___
这三种写法在 GitHub、Typora、Obsidian、VS Code 插件等所有主流平台均 100% 兼容,【必须独占一行,且符号间不能插入空格】。若写成 - - -(带空格),虽部分编辑器仍能识别,但属于非标准用法,不推荐作为主力写法。
带空行的清爽分隔(视觉优化)
单纯一条横线容易和段落粘连,阅读时边界感弱。最有效的做法是:上一段结尾后回车→输入分割线→再回车→下一段开始。
上一段文字结束。
---
下一段文字从此开始。
这种“空行+分割线+空行”结构让分隔更呼吸感十足,是 2026 年技术文档与周报写作中的事实标准。
带 emoji 的标题式分割线(场景化增强)
当需要强调某一块内容的主题时,可在分割线前后各加一行带 emoji 的小标题,形成视觉锚点。
### ? 核心功能
---
### ⚙️ 配置说明
---
### ❓ 常见问题
注意:这里的 ### 是真实标题语法,不是装饰;分割线必须另起一行,不能和标题写在同一行。否则标题会被解析失败。
超粗渐变风分割线(高级定制)
方法一:HTML 内联样式(仅限支持 HTML 渲染的平台,如 Typora、Obsidian、语雀)
方法二:使用自定义 CSS(需主题支持,如 Hexo、Hugo 主题配置)
在站点 CSS 文件中添加:
.fancy-divider { border-top: 3px double #ec4899; margin: 24px 0; }
然后在 Markdown 中写:<div class="fancy-divider"></div>
【此写法在 GitHub README 和纯静态 Markdown 查看器中完全不显示】,务必确认目标平台支持 HTML 渲染后再使用。
易踩坑的错误写法
第一步:避免在分割线行内混入文字,例如 --- 分隔线 --- → 渲染失败,变成普通文本。
第二步:不要用四个以上减号但中间加空格,例如 - - - - → 虽然多数编辑器仍识别,但属于模糊匹配,GitLab 某些旧版本会忽略。
第三步:禁止用中文破折号(——)、长横线(—)或全角符号替代英文短横,它们不会被任何解析器识别。


















