djlint 1.42.1

HTML Template Linter and Formatter

The missing formatter and linter for HTML templates.

How to use • Как пользоваться • Utilisation • 如何使用

What lang are you using?

Django • Jinja • Askama • Tera • Liquid • Nunjucks • Twig • Handlebars • Mustache • GoLang • Angular

🤔 For What?

Once upon a time all the other programming languages had a formatter and linter. Css, javascript, python, the c suite, typescript, ruby, php, go, swift, and you know the others. The cool kids on the block.

HTML templates were left out there on their own, in the cold, unformatted and unlinted :( The dirty corner in your repository. Something had to change.

djLint is a community build project to and add consistency to html templates.

✨ How?

Grab it from PyPI with pip

pip install djlint

Or as a standalone tool with uv

uv tool install djlint

Or with pipx

pipx install djlint

Or with the community-maintained Homebrew formula on macOS or Linux

brew install djlint

Or with npm - warning: the npm package is only a wrapper, its install script runs pip install --upgrade djlint on whatever python3 is on your system path. npm will not manage or uninstall the actual package - prefer pip directly when possible.

npm i djlint

Lint your project

djlint . --extension=html.j2 --lint

Check your format

djlint . --extension=html.j2 --check

Fix my format!

djlint . --extension=html.j2 --reformat

Or use pre-commit to reformat, then lint!

repos:
  - repo: https://github.com/djlint/djLint
    rev: v1.41.0 # use latest version instead
    hooks:
      - id: djlint-reformat
      - id: djlint

💙 Like it?

Add a badge to your projects readme.md:

[![Code style: djlint](https://img.shields.io/badge/html%20style-djlint-blue.svg)](https://www.djlint.com)

Add a badge to your readme.rst:

.. image:: https://img.shields.io/badge/html%20style-djlint-blue.svg
   :target: https://www.djlint.com

Looks like this:

🛠️ Can I help?

Yes!

Would you like to add a rule to the linter? Take a look at the linter docs and source code

Are you a regex pro? Benchmark and submit a pr with improved regex for the linter rules

🏃 Other Tools Of Note

• djade A fast Django template formatter that formats template syntax whilst leaving HTML as-is, and applies fixes for older Django versions.
• djangofmt A fast, HTML-aware Django/Jinja template formatter written in Rust that formats HTML and template syntax together.
• DjHTML A pure-Python Django/Jinja template indenter without dependencies.
• prettier-plugin-jinja-template Prettier plugin for formatting Jinja and Django templates.
• Twig-CS-Fixer A PHP tool that lints and automatically fixes Twig coding-standard issues.