tags (H036) Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Replace forced line breaks with block elements and CSS margins to maintain semantic structure and accessibility. ```html
Shipping is free.
Delivery takes 3 days.
Shipping is free.
Delivery takes 3 days.
``` -------------------------------- ### H006: Require height and width on img tags Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Define image dimensions to prevent layout shifts during page loading. Enable this rule with --include=H006. ```html
```
```html
```
--------------------------------
### H010: Use lowercase attribute names
Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md
Lowercase attribute names ensure compatibility and consistent text searching across templates.
```html
```
```html
```
--------------------------------
### Enforce self-closing void tags (H017)
Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md
Use XHTML-style self-closing slashes for void elements. Enable with --include=H017.
```html
``` ```html
``` -------------------------------- ### Use HTTPS for external links (H022) Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Ensure all external links use HTTPS to prevent interception and tampering. ```html Example ``` ```html Example ``` -------------------------------- ### H007: Require DOCTYPE declaration Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Ensure a DOCTYPE is present before the html tag to avoid quirks mode rendering. ```html ``` ```html ``` -------------------------------- ### T001: Template Variable Spacing Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Ensures template variables are wrapped in whitespace for better readability and grep consistency. ```html {{user.name}} ``` ```html {{ user.name }} ``` -------------------------------- ### Remove extra blank lines (H014) Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Avoid excessive blank lines to reduce template bloat and noisy diffs. ```html
one
two
``` ```htmlone
two
``` -------------------------------- ### Enforce plain void tag endings (H018) Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Use plain > endings for void elements to follow the HTML living standard. Enable with --include=H018. ```html``` ```html
``` -------------------------------- ### Use lowercase form method values (H029) Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Use lowercase keywords for form methods to ensure consistency and compatibility with strict validators. ```html ``` ```html ``` -------------------------------- ### Fix unclosed template strings (T027) Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Ensure all strings within template tags are properly closed to avoid parsing errors. ```html {% trans "Welcome %} ``` ```html {% trans "Welcome" %} ``` -------------------------------- ### Identify unclosed template tags (T039) Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Catch syntax errors where template tags are missing their closing delimiters. ```django
{{ user.name }
``` ```django{{ user.name }}
``` -------------------------------- ### Not Recommended Spaces Around Conditional Attributes Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/best-practices.md This pattern is not recommended as djLint removes whitespace inside conditional statements, potentially leading to unexpected formatting. ```htmlcontent
```
--------------------------------
### H009: Use lowercase tag names
Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md
Use lowercase for all HTML tags to ensure compatibility with XHTML/XML and improve searchability.
```html
Welcome
``` ```htmlWelcome
``` -------------------------------- ### Validate template name in extends/include (T040) Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Ensure template tags like extends or include contain a valid, non-empty template name. ```django {% extends "" %} ``` ```django {% extends "base.html" %} ``` -------------------------------- ### Avoid inline styles (H021) Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Move inline styles to CSS classes to improve maintainability and comply with Content Security Policies. ```htmlWrong username or password.
```
```html
Wrong username or password.
```
--------------------------------
### Correct template tag delimiters (T034)
Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md
Ensure template tags are closed with %} instead of }% to avoid syntax errors or raw text leakage.
```html
{% include "footer.html" %}
```
```html
{% include "footer.html" %}
```
--------------------------------
### Ignore specific linter rules
Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/ignoring-code.md
Specify rule codes within the opening tag to disable only those rules for the block.
```html
{# djlint:off H025,H026 #}
{# djlint:on #}
{% comment %} djlint:off H025 {% endcomment %}
{% comment %} djlint:on {% endcomment %} {{!-- djlint:off H025 --}}
{{!-- djlint:on --}} {{ /* djlint:off H025 */ }}
{{ /* djlint:on */ }} ``` -------------------------------- ### Recommended Spaces Around Conditional Attributes Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/best-practices.md djLint removes whitespace inside conditional statements. This pattern is recommended for cleaner formatting. ```html
content
```
--------------------------------
### H013: Require alt attribute on img tags
Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md
Provide alt text for images to satisfy accessibility requirements and improve user experience when images fail to load.
```html
```
```html
```
--------------------------------
### Recommended Spaceless Conditional Attributes
Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/best-practices.md
When `format_attribute_template_tags` is enabled, use spaceless tags within conditional attributes to prevent unwanted spaces. This pattern is recommended.
```html
```
--------------------------------
### Enforce self-closing meta tags (H035)
Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md
Use this rule to ensure meta tags are XHTML-compatible by including a trailing slash.
```html
```
```html
```
--------------------------------
### Use literal characters instead of entity references (H023)
Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md
Use literal UTF-8 characters instead of entity references for better readability and to avoid rendering errors.
```html
Dates 1900 — 2000
``` ```htmlDates 1900 — 2000
``` -------------------------------- ### Validate matching block tags (T038) Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Ensure all template block tags have corresponding closing tags to prevent template syntax errors. ```django {% if user.is_authenticated %}Welcome back!
``` ```django {% if user.is_authenticated %}Welcome back!
{% endif %} ``` -------------------------------- ### H008: Use double quotes for attributes Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Standardize on double quotes for attribute values to improve consistency and avoid issues with apostrophes. ```html ``` ```html ``` -------------------------------- ### Add line breaks after heading tags (H015) Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Ensure block-level elements follow headings to maintain document structure and clean diffs. ```htmlHeading
Intro text.
``` ```htmlHeading
Intro text.
``` -------------------------------- ### Remove empty id and class attributes (H026) Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Remove empty id or class attributes as they serve no purpose and can indicate template bugs. ```htmlcontent
```
```html
content
```
--------------------------------
### H005: Require lang attribute on html tag
Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md
Include a lang attribute on the html tag to support screen readers and browser translation features.
```html
```
```html
```
--------------------------------
### Remove extra whitespace in template tags (T032)
Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md
Avoid unnecessary spaces between template tag arguments to maintain clean diffs and consistent formatting.
```html
{% static 'css/style.css' %}
```
```html
{% static 'css/style.css' %}
```
--------------------------------
### Remove empty tag pairs (H020)
Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md
Avoid empty tags that create unnecessary DOM nodes. Tags with attributes or specific semantic elements are exempt.
```html
Saved.
``` ```htmlSaved.
``` -------------------------------- ### T002: Double Quotes in Tags Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Standardizes the use of double quotes within template tags to ensure consistency across the codebase. ```html {% extends 'base.html' %} ``` ```html {% extends "base.html" %} ``` -------------------------------- ### T003: Named Endblock Tags Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Requires endblock tags to include the block name to prevent nesting errors and improve readability. ```html {% block content %}hello
{% endblock %} ``` ```html {% block content %}hello
{% endblock content %} ``` -------------------------------- ### Require title tag in HTML (H016) Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md Every complete HTML document must include a title element for accessibility and SEO. ```html Content ``` ```htmlHello
``` ```htmlHello
...
```
```html
...
```
--------------------------------
### Enforce tag closure within the same block (H041)
Source: https://github.com/djlint/djlint/blob/master/docs/src/docs/linter.md
Keep HTML tags opened and closed within the same template block to ensure child templates can override blocks safely.
```django
{% block content %}
{% endblock content %}
{% block footer %}
{% endblock footer %}
```
```django
{% block content %}