直接修改 pre 和 code 的 css 即可提升 html 源码可读性:设 white-space: pre-wrap、tab-size: 2/4、等宽字体栈、line-height: 1.5、深灰背景(#2d2d2d)、浅灰文字(#e0e0e0)、1px 边框与 4px 圆角、20px 内边距。

直接改 pre 和 code 标签的 CSS 就能控制 HTML 源码在网页里的可读性,不需要 JS 渲染或服务端预处理。
用 white-space 保留原始换行和缩进
浏览器默认会把连续空格、制表符、换行全压缩成一个空格。要显示真实缩进结构,必须显式设置 white-space:
-
white-space: pre:保留空格和换行,但不自动换行(长行会撑破容器)
-
white-space: pre-wrap:保留空格和换行,且允许长行自动折行(最常用)
-
white-space: pre-line:合并连续空格,但保留换行(适合纯文本段落,不适合代码)
推荐对 pre 元素统一设为 pre-wrap,再配合 overflow-x: auto 防止横向溢出。
Doc To HTML
使用 MinerU 文档处理引擎将 Word 文档(.doc、.docx)转换为保留结构和格式的干净 HTML。
下载
字体选等宽 + 行高调到 1.4–1.6
非等宽字体(如 Arial、Times)会让 HTML 标签对齐错乱,<div> 和 <code>
看起来就不在垂直线上。
- 用
font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace 这类栈式声明,兼顾系统兼容性
-
line-height: 1.5 是平衡可读性和密度的甜点值;低于 1.3 容易粘连,高于 1.8 显得松散
- 避免用
font-size: 12px 以下——小字号+等宽字体在高分屏上极易糊成一片
加背景色和边框但别用纯黑底白字
纯黑背景(#000)配纯白文字(#fff)对比度过高,长时间阅读会视觉疲劳,尤其在暗光环境。
- 推荐深灰背景:
background-color: #2d2d2d(VS Code 默认深色主题底色)
- 文字用浅灰而非纯白:
color: #e0e0e0(保留层次感,避免刺眼)
- 加 1px 边框和圆角:
border: 1px solid #444 + border-radius: 4px,让代码块有边界感
- 别给
pre 加 padding 太大——20px 已足够,否则缩进会被“吃掉”一层
关键细节:不要忽略 tab-size
HTML 源码里大量使用 Tab 缩进,但浏览器默认把 Tab 当作 8 个空格,导致缩进过宽、层级错位。
- 必须显式设置
tab-size: 2 或 tab-size: 4(根据团队规范)
- 这个属性只对
pre 和 code 生效,且不被 IE 支持(但 IE 已淘汰)
- 如果用了 Prettify、Prism 等高亮库,确认它们没覆盖你的
tab-size 值——有些库会强制重置
真正影响阅读体验的不是炫酷动画或复杂语法树,而是空格是否对齐、Tab 是否按预期展开、换行是否自然折断——这些细节一旦设错,整段 HTML 就像被揉皱后又摊开的纸,结构还在,但没人想细看。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!