代码

HTML 格式化工具:设置易读的排版,再检查源码变化

·

HTML 格式化工具把紧凑的标记整理成更容易检查的源代码。ToolMellow 使用 Prettier 的 HTML 解析器,提供缩进、建议行宽和每行一个属性选项。粘贴片段或导入本地文本文件,再点「格式化 HTML」,生成独立的「结果」。

把结果放入网页或模板之前,请先检查改动。格式化可能改变引号、标签布局和闭合标记;它不会净化 HTML、证明文档符合标准,也不会展示浏览器渲染效果。下面说明各选项的作用,以及怎样保留完整输出。

HTML 格式化工具

格式化整个输入,再检查结果

想比较选项时,可以先用「试用示例」载入一小段标记。处理自己的源码时,粘贴到「输入」或选择本地文件。「格式化 HTML」始终处理整个输入,选中一部分不会缩小处理范围。

格式化成功后,原输入不变,排版后的文字放入只读的「结果」。编辑输入或更改格式选项会清除旧结果;需要再次运行才能生成新结果。这样可避免复制属于旧版本的输出。

  • 编辑或替换源码前,保留原文件副本。
  • 选择两个或四个空格作为缩进。
  • 把建议行宽设在 40 到 200 之间。
  • 需要展开多属性标签时,启用「每行一个属性」。
  • 运行「格式化 HTML」,检查标记改动及错误信息。
  • 复制或下载完整结果;结果符合输入限制时,也可以将它用作输入。

哪些设置可以调整?

可见控件只开放了少量 Prettier 选项。空白敏感度和内嵌语言格式化在这里采用固定设置,没有额外开关可切换空白模式,或启用 script、style 内容的独立格式化。

同一个排版选项,遇到不同标记可能产生不同布局。长属性值仍可能超过建议行宽;即使启用了属性换行,只有一个属性的标签也可能保持在一行。

哪些设置可以调整?
设置本工具的值含义
解析器html把整个输入作为 HTML 源码格式化。
缩进2 或 4 个空格设置每级缩进的宽度。
建议行宽40–200;默认 80引导换行,但不强制每行都小于该值。
每行一个属性可选对适用的多属性标签请求属性分行。
空白敏感度strict排版时把标签周围的空白视为有意义的内容。
内嵌语言格式化off不单独美化 HTML 内的 JavaScript 或 CSS。
自动换行显示选项改变文本框的折行显示,不改写源码。
结果只读只有新的格式化成功后,才接收输出。

Prettier 格式化选项WHATWG HTML:语法和元素

为嵌套层级选择两个或四个空格

两个空格能让深层嵌套相对紧凑,四个空格则更突出层级。尽量遵循项目已有的约定,避免粘贴格式化片段时引入不必要的风格变化。

缩进是排版偏好,不能修复缺失元素或损坏的属性。严格空白处理可能让某些行内内容保持在一起,也可能把结束尖括号移到另一行。这些布局本身不表示缩进选项失效。

把行宽当作排版偏好

建议行宽接受 40 到 200,初始值为 80。较小的值倾向于生成短行,较大的值允许更多标记保持在一起。Prettier 的打印宽度是易读布局的目标,不是每一行都必须遵守的硬性上限。

例如,一个长达 250 个字符的属性值仍可能让某行超过设为 40 的行宽。格式化器不会仅为凑足列数而把该值拆开。请检查结果中的长 URL、模板表达式和其他不可拆分的文字。

把行宽当作排版偏好
场景可尝试的设置取舍
较窄的检查窗口试用 40在排版器能够引入换行的位置,可能出现更多换行。
一般编辑从 80 开始适中的建议宽度。
较宽的编辑器试用 120更多标签和属性可能保留在一起。
很宽的源码视图最高 200由行宽引起的换行可能更少,仍取决于标记。
很长的属性值任意支持的行宽属性值仍可能超过建议值。
已启用每行一个属性结合所需的建议行宽属性布局也会影响结果。

Prettier 格式化选项

按需把属性分到不同行

启用「每行一个属性」,可以更方便地逐项检查适用的多属性标签,例如名称、无障碍属性或较长的数据属性。这是属性布局偏好,不要求每个开始标签都展开成多行。

只有一个属性的 <img src="x">,仍可能格式化为同一行的 <img src="x" />。特殊语法结构也可能遵循自己的排版规则。把这种布局用于整个模板前,先检查实际结果。

Prettier 格式化选项

为什么有些标签和尖括号在意外的位置换行?

本工具把 HTML 空白敏感度固定为 strict。行内标签旁的空白会影响文字,因此排版器可能让 <p>Hello <strong>world</strong>!</p> 这样的内容保持在一起。其他布局中,结束尖括号也可能与标签名称分处两行。

严格处理不承诺逐字节保留空白,也不保证所有输入的渲染效果完全一致。特别是 pre 和 textarea 内容周围的布局也可能改变。请检查对空白敏感的文字,并在实际网页或模板环境中测试。

Prettier 格式化选项

HTML 内的 JavaScript 和 CSS 不单独格式化

内嵌语言格式化固定为 off。const x={a:1,b:2}; 这样的脚本内容,或 .x{color:red;padding:0} 这样的样式内容,不会经过独立的 JavaScript 或 CSS 美化步骤。界面没有启用该步骤的开关。

HTML 排版器仍可能移动周围标签、缩进和换行,也可能改变这些代码内容周围的布局。因此,关闭内嵌格式化不等于整个脚本或样式区域逐字节不变。替换原文件前,检查内嵌代码和模板分隔符。

Prettier:内嵌语言格式化

需要检查的不只是新增缩进

HTML 美化工具会解析并重新输出标记,改动可能超出行首空格。下表描述的是特定输入下已观察到的输出,不承诺每个格式不完整的文档都会被接受,或按同样方式补齐。

处理生成的标记、HTML 邮件或模板语言时,应有意识地比较源码差异。格式化不能代替项目测试,也不能代替在目标浏览器和模板引擎中检查结果。

需要检查的不只是新增缩进
输入特征观察到的变化需要检查
未加引号或使用单引号的属性属性引号可能变成双引号。检查引号及模板表达式。
空元素,例如 <input disabled>输出可能加入闭合斜杠。检查接收系统要求的语法。
<div>hello 缺少结束标签输出可能加入 </div>。解析成功不等于完整的有效性检查。
CRLF 行尾格式化输出使用 LF。在差异中检查行尾变化。
行内文字和标签内容可能保持在同一行。避免加入会改变文字的空格。

WHATWG HTML:语法和元素

阅读解析错误,但别把成功当作完整校验

解析器拒绝源码时,工作区会显示本地化的错误概述和引擎原始详情,详情中可能含行号和列号。用该位置检查附近源码;原因也可能始于报告位置之前。修改「输入」后,再运行「格式化 HTML」。

解析器也可能接受省略或缺失结束标签的标记,并输出推断出的闭合标记。因此成功不证明 HTML 符合规范、具备无障碍性、内容安全或模板行为正确。这里没有独立校验报告或渲染预览。

WHATWG HTML:语法和元素

分清输入、文件和历史记录的限制

文字限制按 UTF-16 代码单元计算,与文件字节数、可见字符数不同。基本拉丁字母占一个单元,🌿 这样的辅助平面字符占两个,显示为一个表情的序列可能包含多个码点。本地文件必须同时通过字节检查和解码后的文字检查。

格式化可能让输出超过输入上限。完整结果仍可复制和下载,但「将结果用作输入」会拒绝过大的结果,并保留已有输入与结果。下表把这些限制与查找、历史记录限制分开列出。

分清输入、文件和历史记录的限制
项目限制边界行为
粘贴或处理的输入1,000,000 个 UTF-16 代码单元恰好达到上限可以接受,更长的文字会被拒绝。
本地文件严格小于 4,000,000 字节恰好达到该字节数的文件会在读取前被拒绝。
解码后的文件文字1,000,000 个 UTF-16 代码单元UTF-8 解码后仍须符合输入上限。
将结果用作输入1,000,000 个 UTF-16 代码单元过大的输出不会插入,但完整结果仍可导出。
查找文本1,000 个 UTF-16 代码单元输入中的原文查找有长度限制。
替换文字10,000 个 UTF-16 代码单元导致输入超过上限的替换会被拒绝。
撤销和重做历史最多 20 个较早快照记录已接受的输入变化,不单独记录格式化结果。
合计历史文字4,000,000 个 UTF-16 代码单元不包括当前输入;较早保存的状态受限。

以 UTF-8 文字导入本地 HTML

选择本地 HTML 或文本文件,把源码载入「输入」。工作区先检查文件大小,再用文件的文字读取方法按 UTF-8 解码,然后检查解码后的长度。这里没有编码选择器,修改文件名或 MIME 类型不会切换解码方式。

这是文本文件导入,不会从 URL 抓取页面、从 PDF 或 Word 提取 HTML,也不会打开关联脚本、样式或图片。如果文件采用其他编码而显示乱码,请先用合适的编辑器转为 UTF-8,再导入。

W3C File API:Blob 文字解码

复制或下载完整的 HTML 结果

复制和下载使用整个「结果」,不限于当前选区或编辑器可见部分。下载会生成名为 toolmellow-result.html 的 UTF-8 文本文件,里面是格式化后的源码,不是截图或页面依赖打包文件。

请同时保留该源码所需的资源和构建步骤。下载文件不包含外部样式表、图片或脚本。发布之前先检查并测试标记,尤其是原始内容来自不可信来源时。

只有符合上限的输出才能重新作为输入

「将结果用作输入」会用符合文字上限的成功结果替换输入,便于继续编辑。单独生成「结果」不会改写输入。若还需要原文,请先保存,或在替换被接受后使用尚可用的输入历史。

如果输入恰好是一百万个普通字母,末尾新增一个换行便可能生成 1,000,001 个输出单元。它仍可完整复制或下载,但不能重新放回输入。拒绝复用不表示结果已被截断。

查找、折行、历史和清空作用不同

查找替换针对「输入」中的原文,可选择区分大小写。它不使用正则表达式,也不理解 HTML 节点和属性。$& 这样的替换文字会原样插入;修改重复标记前,先检查匹配。已接受的编辑会清除旧结果。

「自动换行」只改变输入和结果文本框显示长行的方式,不会在复制或下载的源码里新增换行。即使界面语言从右向左书写,HTML 源码仍保持从左向右。

撤销和重做记录已接受的输入编辑、导入、替换和结果复用,受历史上限约束。它们不撤销单独生成结果这个动作。「清空」会删除输入、结果、历史与查找状态,但保留格式选项和自动换行偏好,且不能撤销。

本地格式化仍需要载入处理引擎

格式化在浏览器工作线程中运行。输入和输出是文字,不会作为网页挂载,因此不会运行粘贴的脚本或加载粘贴的图片 URL。这种隔离不会把源码净化成可安全发布的内容。工作线程和格式化资源载入时可能需要网络,本地处理本身不保证离线可用。

如果引擎未能载入,请保留输入,在网络恢复后重新运行。「取消」可以终止待完成任务并保留输入。启动和处理设有 60 秒的时限,但实际完成时间取决于浏览器和源码。已取消或过时的工作不能当作新的结果。

Prettier:在浏览器中运行

常见问题

格式化 HTML 会净化内容吗?

不会。工作区把源码作为文字输出,不执行它,但不会移除危险内容或让结果自动适合发布。请在实际使用源码的位置采用适当的净化和安全措施。

建议行宽是硬性上限吗?

不是。支持 40–200 的偏好值,默认 80。长属性值和其他不可拆分内容可能超过所选宽度。

能修复不合法的 HTML 吗?

对某些可接受的输入,它可能补上推断的闭合标记;其他输入则会报解析错误。这不是通用修复工具或 HTML 合规校验器,请检查结果并在目标环境测试。

为什么行内 HTML 标签保持在一起?

空白敏感度固定为 strict。排版器重视标签周围的空白,可能保留行内文字,也可能把结束尖括号移到另一行。请检查对空白敏感的内容,不要假定每个标签都应独占一行。

HTML 内的 JavaScript 和 CSS 会重新格式化吗?

不会进行独立的内嵌 JavaScript 或 CSS 格式化,也没有启用它的开关。HTML 排版仍会改变周围的缩进和行布局,因此不保证内嵌区域逐字节不变。

最多能粘贴或导入多少 HTML?

输入最多 1,000,000 个 UTF-16 代码单元。本地文件必须严格小于 4,000,000 字节,且其 UTF-8 解码后的文字也要符合输入上限。字节、代码单元和可见字符是不同计量。

能只格式化选中的 HTML 吗?

不能。「格式化 HTML」处理整个输入,选区不会缩小范围。若只想整理某个片段,请把该片段单独放入输入。

格式化和清空能撤销吗?

格式化会生成独立结果,并保留输入。撤销和重做只用于可用历史中的已接受输入变化。「清空」删除输入、结果、查找和历史,不能撤销。

这里有实时 HTML 预览吗?

没有。输入和结果都是源码编辑器,工具不会把粘贴的标记渲染成页面、抓取关联资源或展示实时浏览器预览。

启用属性换行后,为什么标签仍在一行?

「每行一个属性」用于适用的多属性布局。只有一个属性的标签可能保持一行,特殊结构也可能有自己的排版规则。

自动换行会改变下载的 HTML 吗?

不会。它是文本框的显示偏好。下载始终包含完整格式化结果及实际源码换行,不取决于屏幕上的折行方式。

能导入 URL、PDF 或 Word 文档吗?

这里只接受本地文本文件内容,不会从 URL 获取 HTML,或从 PDF、Word 文件提取文档内容。

为什么结果可以下载,却大到不能用作输入?

格式化可能让文字超过输入上限。复制与下载仍保留完整结果,但放回输入会超过其 1,000,000 单元限制,因此被拒绝,结果本身不会被丢弃。

可以压缩 HTML 吗?

这里没有 HTML 压缩操作。「格式化 HTML」根据设置输出易读源码,不提供压缩模式,也不保证结果更小。

主要参考资料

动手试试。

相关指南