命令行界面（CLI）

命令行工具名为minhtml。预编译的二进制文件适用于Linux（ARM64和x64）、macOS（ARM64和x64）和Windows（x64）。您可以在GitHub发行版中下载它们。

如果您已安装Cargo，也可以从源代码构建和安装：cargo install minhtml。

使用

使用--help参数获取更多详细信息。

minhtml --output /path/to/output.min.html --keep-closing-tags --minify-css /path/to/src.html

就地并行处理多个文件

minhtml --keep-closing-tags --minify-css /path/to/**/*.html

Rust

获取

[dependencies]
minify-html = "0.15.0"

使用

查看API和使用示例的文档。

Deno

• 包： https://wilsonl.in/minify-html/deno/0.15.0/index.js
• 绑定： WASM
• 平台：所有平台

使用

import init, {minify} from "https://wilsonl.in/minify-html/deno/0.15.0/index.js";

const encoder = new TextEncoder();
const decoder = new TextDecoder();

await init();

const minified = decoder.decode(minify(encoder.encode("<p>  Hello, world!  </p>"), { keep_spaces_between_attributes: true, keep_comments: true }));

所有Cfg字段都作为对象提供的第二个参数上的snake_case属性可用；如果未设置，则默认为false。

Node.js

• 包： @minify-html/node
• 绑定： Neon
• 平台：Linux（ARM64和x64）、macOS（ARM64和x64）、Windows（x64）；Node.js 8.6.0及以上

获取

使用npm

npm i @minify-html/node

使用Yarn

yarn add @minify-html/node

使用

提供TypeScript定义。

import { Buffer } from "node:buffer";
import minifyHtml from "@minify-html/node";
// Or `const minifyHtml = require("@minify-html/node")` if not using TS/ESM.

const minified = minifyHtml.minify(Buffer.from("<p>  Hello, world!  </p>"), { keep_spaces_between_attributes: true, keep_comments: true });

所有Cfg字段都作为对象提供的第二个参数上的snake_case属性可用；如果未设置，则默认为false。

Java

• 包： in.wilsonl.minifyhtml
• 绑定： JNI
• 平台：Linux（ARM64和x64）、macOS（ARM64和x64）、Windows（x64）；Java 7及以上

获取

作为Maven依赖项添加

<dependency>
  <groupId>in.wilsonl.minifyhtml</groupId>
  <artifactId>minify-html</artifactId>
  <version>0.15.0</version>
</dependency>

使用

import in.wilsonl.minifyhtml.Configuration;
import in.wilsonl.minifyhtml.MinifyHtml;

Configuration cfg = new Configuration.Builder()
    .setKeepHtmlAndHeadOpeningTags(true)
    .setMinifyCss(true)
    .build();

String minified = MinifyHtml.minify("<p>  Hello, world!  </p>", cfg);

所有Cfg字段都作为Builder上的camelCase设置方法可用；如果未设置，则默认为false。

Python

• 包： minify-html
• 绑定： PyO3
• 平台：Linux（ARM64和x64）、macOS（ARM64和x64）、Windows（x64）；Python 3.8至3.12

获取

将PyPI项目作为依赖项添加，并使用pip或pipenv安装。

使用

import minify_html

minified = minify_html.minify("<p>  Hello, world!  </p>", minify_js=True, remove_processing_instructions=True)

所有Cfg字段都作为Python关键字参数可用；如果省略，则默认为False。

Ruby

• 包： minify_html
• 绑定： rb-sys 和 magnus
• 平台：Linux (ARM64 和 x64)、macOS (ARM64 和 x64)、Windows (x64)；Ruby 2.7 到 3.2

获取

将库作为依赖项添加到 Gemfile 或 *.gemspec。

使用

require 'minify_html'

print minify_html("<p>  Hello, world!  </p>", { :keep_spaces_between_attributes => true, :minify_js => true })

所有 Cfg 字段 都是可用的；如果省略了任何字段，则默认为 false。

WASM

• 包： @minify-html/wasm
• 绑定： WASM
• 平台：所有平台

可能需要 bundler 来使用 WebAssembly 模块，有关详细信息，请参阅 此处。

使用

import init, {minify} from "@minify-html/wasm";

const encoder = new TextEncoder();
const decoder = new TextDecoder();

await init();

const minified = decoder.decode(minify(encoder.encode("<p>  Hello, world!  </p>"), { keep_spaces_between_attributes: true, keep_comments: true }));

所有Cfg字段都作为对象提供的第二个参数上的snake_case属性可用；如果未设置，则默认为false。

应用范围：任何元素，除了 对空白敏感 元素。

将文本节点中的空白字符序列减少为单个空格（U+0020）。

<p>↵
··The·quick·brown·fox↵
··jumps·over·the·lazy↵
··dog.↵
</p>

<p>·The·quick·brown·fox·jumps·over·the·lazy·dog.·</p>

适用范围：除了以下元素以外的任何元素：空格敏感、内容、内容优先和格式化元素。

删除标签之间的仅由空白字符组成的文本节点。

<ul>↵
··<li>A</li>↵
··<li>B</li>↵
··<li>C</li>↵
</ul>

<ul>↵
··<li>A</li><li>B</li><li>C</li>↵
</ul>

适用范围：除了以下元素以外的任何元素：空格敏感和格式化元素。

删除标签的任何前导/尾部空白字符。

<p>↵
··Hey,·I·<em>just</em>·found↵
··out·about·this·<strong>cool</strong>·website!↵
··<sup>[1]</sup>↵
</p>

<p>Hey,·I·<em>just</em>·found↵
··out·about·this·<strong>cool</strong>·website!↵
··<sup>[1]</sup></p>

空白被折叠。

格式化元素通常是行内元素，它们围绕内容元素中的某些文本进行包裹，因此其空白不会像它们可能是内容的一部分那样被裁剪。

空白被裁剪和折叠。

内容元素通常代表连续的完整内容单元，例如一个段落。因此，空白很重要，但空白序列最可能是由于格式化引起的。

之前

<p>↵
··Hey,·I·<em>just</em>·found↵
··out·about·this·<strong>cool</strong>·website!↵
··<sup>[1]</sup>↵
</p>

之后

<p>Hey,·I·<em>just</em>·found·out·about·this·<strong>cool</strong>·website!·<sup>[1]</sup></p>

空白被裁剪和折叠。整个空白被删除。

这些元素应只包含其他元素，不包含文本。这使得删除整个空白成为可能，这在使用display: inline-block时很有用，这样元素之间的空白（例如缩进）就不会改变布局和样式。

之前

<ul>↵
··<li>A</li>↵
··<li>B</li>↵
··<li>C</li>↵
</ul>

之后

<ul><li>A</li><li>B</li><li>C</li></ul>

空白被裁剪和折叠。

这些元素通常是内容元素，但偶尔也像只有一个子元素布局元素一样使用。整个空白不会被删除，因为它可能包含内容，但这是可以接受的，因为只有一个子元素，并且空白已被裁剪。

之前

<li>↵
··<article>↵
····<section></section>↵
····<section></section>↵
··</article>↵
</li>

之后

<li><article><section></section><section></section></article></li>