Tidy

HTML Tidy Plugin

Corrects and cleans up HTML and XML documents. Fixes markup errors, improves layout, enforces consistent style, and converts between HTML versions.

Commands

Checking

• tidy check lint — Check HTML file for errors and warnings (no modifications)
• tidy check errors — Show only errors (no warnings)

Fixing

• tidy fix run — Clean and repair HTML file (output to stdout)
• tidy fix inplace — Clean and repair HTML file in-place (modifies the file)

Conversion

• tidy convert to-xhtml — Convert HTML to XHTML
• tidy convert to-html5 — Convert HTML to HTML5

Configuration

• tidy config show — Show current tidy configuration
• tidy help options — Show all available tidy options

Utility

• tidy self version — Print tidy version

Passthrough

• tidy _ _ — Passthrough to tidy CLI

Usage Examples

• "Check my HTML file for errors"
• "Clean up and fix this HTML file"
• "Convert HTML to XHTML"
• "Show only errors, no warnings"
• "Format HTML with consistent indentation"

Installation

brew install tidy-html5

Or via apt:

sudo apt-get install tidy

Examples

# Check HTML for errors (no modifications)
sc tidy check lint --file index.html

# Show only errors (no warnings)
sc tidy check errors --file index.html

# Clean and repair HTML (output to stdout)
sc tidy fix run --file messy.html

# Clean and repair HTML in-place (modifies file)
sc tidy fix inplace --file index.html

# Convert HTML to XHTML
sc tidy convert to-xhtml --file index.html

# Convert HTML to HTML5
sc tidy convert to-html5 --file legacy.html

# Show current configuration
sc tidy config show

# Passthrough: check with custom indent
sc tidy _ _ -indent --wrap 120 index.html

# Passthrough: clean presentational clutter
sc tidy _ _ --clean --indent index.html

Key Features

• Error checking — Detects and reports HTML markup errors
• Cleaning — Fixes common HTML issues automatically
• Indentation — Consistent indentation and formatting
• HTML version conversion — Convert between HTML4, XHTML, HTML5
• Configurable — Hundreds of configuration options
• XML support — Can process XML documents too
• Non-destructive lint — Check without modifying files
• In-place fix — Modify files directly with -m flag