How to use: English • 简体中文 • 日本語 • Español • Português (Brasil) • Русский • 한국어 • Français • Deutsch • 繁體中文 • Italiano • Polski • Čeština • Türkçe
Django • Jinja • Twig • Nunjucks • Handlebars • Mustache • Liquid • Go templates • Angular • Tera • Askama • Mako
Generic HTML tools can't parse {% %} and {{ }}, and template engines don't care what the markup around them looks like. So indentation drifts, tags go unclosed and spacing goes wherever, and none of it gets caught in review.
djLint reads HTML and the template syntax inside it, with profiles for Django, Jinja, Twig, Nunjucks, Handlebars, Liquid, Go templates and more. It runs from the command line, as a pre-commit hook and as a language server in your editor.
Take a template only its author could love:
{% block content %}
<SECTION class="posts">
<h2>Latest posts</h2>
{%if posts%}
<ul>
{% for post in posts %}
<li>
<a href="{% url 'post' post.slug %}" class="post-link {%if post.featured%}is-featured{%endif%}" data-analytics-id="post-{{post.id}}" aria-label="Read {{post.title}}">{{post.title|title}}</a>
</li>
{% endfor %}
</ul>
{%else%}
<p>No posts yet.</p>
{%endif%}
</SECTION>
{% endblock %}One djlint --reformat later:
{% block content %}
<section class="posts">
<h2>Latest posts</h2>
{% if posts %}
<ul>
{% for post in posts %}
<li>
<a href="{% url 'post' post.slug %}"
class="post-link {% if post.featured %}is-featured{% endif %}"
data-analytics-id="post-{{ post.id }}"
aria-label="Read {{ post.title }}">{{ post.title|title }}</a>
</li>
{% endfor %}
</ul>
{% else %}
<p>No posts yet.</p>
{% endif %}
</section>
{% endblock %}One command rebuilt the indentation, fixed the tag case, spread the long tag over lines, normalized the template tags and collapsed stray blank lines.
Rather indent the attributes under the tag and give the closing bracket a line of its own, as Prettier does? Add --single-attribute-per-line:
<a
href="{% url 'post' post.slug %}"
class="post-link {% if post.featured %}is-featured{% endif %}"
data-analytics-id="post-{{ post.id }}"
aria-label="Read {{ post.title }}"
>{{ post.title|title }}</a>The linter catches what formatting can't fix: orphan tags, missing alt attributes, hard-coded URLs and dozens of other checks.
You can try it on your own templates in the online playground.
Add it to your project as a development dependency with uv, or install it with pip. In a JavaScript project, npm adds it with a Python of its own:
uv add --dev djlint
# or
pip install djlint
# or
npm i -D djlintPut uv run or npx in front of the commands below if you used uv or npm, as in uv run djlint . --lint. The installation guide also covers installing it as a standalone tool, and with pipx or Homebrew.
Lint your project:
djlint . --lintSee what formatting would change:
djlint . --checkFormat the files in place:
djlint . --reformatSet a --profile for the rules and formatting of your template language:
djlint . --reformat --profile=djangoOr run it with pre-commit, formatting first and then linting:
repos:
- repo: https://github.com/djlint/djLint
rev: v1.54.0 # use the latest version instead
hooks:
- id: djlint-reformat
- id: djlint- VS Code: install the djLint extension (also on Open VSX).
- Zed: install the djLint extension as a dev extension until it's in Zed's registry. See how.
- Neovim, JetBrains IDEs, Sublime Text, Helix and Emacs: run the language server,
djlint --lsp. See the setup for each. - CI: GitHub Actions and MegaLinter.
Add a badge to your project's readme.md:
[](https://djlint.com)Add a badge to your readme.rst:
.. image:: https://img.shields.io/badge/html%20style-djLint-blue.svg
:target: https://djlint.comLooks like this:
Yes!
Would you like to add a rule to the linter? Take a look at the linter docs and the rule definitions.
Local setup takes two commands:
# install uv first: https://docs.astral.sh/uv/getting-started/installation/
uv sync
# run the test suite
uv run pytest- 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.
- prettier-plugin-twig Prettier plugin for formatting Twig templates.
- Twig-CS-Fixer A PHP tool that lints and automatically fixes Twig coding-standard issues.
- ludtwig A fast Rust linter and formatter for Twig templates that also validates HTML structure and supports auto-fix.