coc-htmldjango

yaegassy

django templates (htmldjango) extension for coc.nvim. Provides formatter, snippets completion and more...

Installation CommandVim prompt

:CocInstall coc-htmldjango

GitHub owner

yaegassy

Version

v0.14.23

npm package

coc-htmldjango

Requirements

coc ^0.0.80

License

MIT

Repository

GitHub

npm latest published 2025-10-19Registry checked 2026-08-23Registry summary

Published Package Summary

coc-htmldjango

django templates (htmldjango) extension for coc.nvim. Provides "formatter", "linter", "completion" and more...

Features

Format
- by djLint (reformat HTML templates) | DEMO
- by DjHTML ("Django/Jinja" template indenter) | DEMO
Lint
- by djLint (Find common formatting issues) | DEMO
Completion
- Completion of snippets data via completionItemProvider
Hover | DEMO
CodeAction | DEMO
Commands
Built-in installer (djLint, DjHTML)

Install

CocInstall:

:CocInstall coc-htmldjango

vim-plug:

Plug 'yaegassy/coc-htmldjango', {'do': 'yarn install --frozen-lockfile'}

Recommended coc-extensions to install together

coc-html

Tool (linter & formatter) detection

Detection order:

htmldjango.djlint.commandPath and htmldjango.djhtml.commandPath settings
current python environment (e.g. djlint and djhtml in "venv")
builtin djlint and djhtml (Installation commands are also provided)

Code Actions

Example key mapping (Code Action related):

nmap <silent> ga <Plug>(coc-codeaction-line)

Actions:

If htmldjango.formatting.provider is djlint or If htmldjango.djlint.enableLint is true
If htmldjango.formatting.provider is djhtml
- Add {# fmt:off #} for this line
- Add {# fmt:on #} for this line

Bult-in install (djLint, DjHTML)

coc-htmldjango allows you to create an extension-only "venv" and install "djlint" and "djhtml".

:CocCommand htmldjango.builtin.installTools

Thanks

License

MIT

This extension is built with create-coc-extension

Read the complete README

django templates (htmldjango) extension for coc.nvim. Provides formatter, snippets completion and more...

Activation Events

onLanguage:htmldjango

Developer Resources

Want to build, test, or contribute to coc.nvim extensions? Explore our official SDK and testing toolkits.

Open Developer Guide

This published npm package does not include a history.md or changelog.md file. Browse its npm versions or repository releases for available release information.

All contributes.commands entries from the published package manifest for coc-htmldjango@0.14.23.

Command (:CocCommand)	Description
htmldjango.showOutput	Show htmldjango output channel
htmldjango.builtin.installTools	Install htmldjango related tools
htmldjango.djlint.format	Run djLint format
htmldjango.djhtml.format	Run DjHTML format
htmldjango.showReferences	Show Variables Block (`{{ ... }}`) or TemplateTags Block (`{% ... %}`) location information for the current file

All contributes.configuration entries from the published package manifest, including each raw property schema for coc-settings.json.

htmldjango.enableboolean

Enable coc-htmldjango extension

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "default": true,
  "description": "Enable coc-htmldjango extension"
}

htmldjango.hoverLangstring

Set the template language to be used for the hover

Default: "django"

Raw JSON Schema

{
  "enum": [
    "django",
    "jinja2"
  ],
  "type": "string",
  "default": "django",
  "description": "Set the template language to be used for the hover"
}

htmldjango.djlint.ignorestring

Codes to ignore (--ignore)

Default: ""

Raw JSON Schema

{
  "type": "string",
  "default": "",
  "description": "Codes to ignore (--ignore)"
}

htmldjango.djlint.indentnumber

Indent spacing (--indent)

Default: 4

Raw JSON Schema

{
  "type": "number",
  "default": 4,
  "description": "Indent spacing (--indent)"
}

htmldjango.djlint.includestring

Codes to include (--include)

Default: ""

Raw JSON Schema

{
  "type": "string",
  "default": "",
  "description": "Codes to include (--include)"
}

htmldjango.djlint.profilestring

Enable defaults by template language (--profile). ops: django, jinja, nunjucks, handlebars, golang

Default: "django"

Raw JSON Schema

{
  "enum": [
    "html",
    "django",
    "jinja",
    "nunjucks",
    "handlebars",
    "golang",
    "angular"
  ],
  "type": "string",
  "default": "django",
  "description": "Enable defaults by template language (--profile). ops: django, jinja, nunjucks, handlebars, golang"
}

htmldjango.djhtml.tabWidthnumber

Set tabwidth (--tabwidth)

Default: 4

Raw JSON Schema

{
  "type": "number",
  "default": 4,
  "description": "Set tabwidth (--tabwidth)"
}

htmldjango.djlint.formatJsboolean

Also format contents of <script> tags (--format-js)

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "default": false,
  "description": "Also format contents of <script> tags (--format-js)"
}

htmldjango.djlint.formatCssboolean

Also format contents of <style> tags (--format-css)

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "default": false,
  "description": "Also format contents of <style> tags (--format-css)"
}

htmldjango.completion.enableboolean

Enable snippets completion

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "default": true,
  "description": "Enable snippets completion"
}

htmldjango.djlint.enableLintboolean

Enable djLint lint (diagnostics)

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "default": true,
  "description": "Enable djLint lint (diagnostics)"
}

htmldjango.djlint.ignoreCaseboolean

Do not fix case on known html tags (--ignore-case)

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "default": false,
  "description": "Do not fix case on known html tags (--ignore-case)"
}

htmldjango.djlint.lintOnOpenboolean

Lint file on opening

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "default": true,
  "description": "Lint file on opening"
}

htmldjango.djlint.lintOnSaveboolean

Lint file on save

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "default": true,
  "description": "Lint file on save"
}

htmldjango.builtin.pythonPathstring

Python 3.x path (Absolute path) to be used for built-in install

Default: ""

Raw JSON Schema

{
  "type": "string",
  "default": "",
  "description": "Python 3.x path (Absolute path) to be used for built-in install"
}

htmldjango.completion.excludearray

Exclude specific key in snippet completion

Default: ["autoescape_paste","comment_paste","comment_selection","for_paste","forempty_paste","if_paste","ifelse_paste","spaceless_paste","verbatim_paste","with_selection","with_paste","trans_paste","blocktrans_paste","blocktrans_with_paste","translate_paste","blocktranslate_paste","blocktranslate_with_paste"]

Raw JSON Schema

{
  "type": "array",
  "default": [
    "autoescape_paste",
    "comment_paste",
    "comment_selection",
    "for_paste",
    "forempty_paste",
    "if_paste",
    "ifelse_paste",
    "spaceless_paste",
    "verbatim_paste",
    "with_selection",
    "with_paste",
    "trans_paste",
    "blocktrans_paste",
    "blocktrans_with_paste",
    "translate_paste",
    "blocktranslate_paste",
    "blocktranslate_with_paste"
  ],
  "description": "Exclude specific key in snippet completion"
}

htmldjango.djhtml.commandPathstring

The custom path to the djhtml (Absolute path).

Default: ""

Raw JSON Schema

{
  "type": "string",
  "default": "",
  "description": "The custom path to the djhtml (Absolute path)."
}

htmldjango.djlint.commandPathstring

The custom path to the djlint (Absolute path).

Default: ""

Raw JSON Schema

{
  "type": "string",
  "default": "",
  "description": "The custom path to the djlint (Absolute path)."
}

htmldjango.djlint.ignoreBlocksstring

Comma list of template blocks to not indent (--ignore-blocks)

Default: ""

Raw JSON Schema

{
  "type": "string",
  "default": "",
  "description": "Comma list of template blocks to not indent (--ignore-blocks)"
}

htmldjango.djlint.lintOnChangeboolean

Lint file on change

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "default": true,
  "description": "Lint file on change"
}

htmldjango.djlint.useGitIgnoreboolean

Use .gitignore file to extend excludes (--use-gitignore)

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "default": false,
  "description": "Use .gitignore file to extend excludes (--use-gitignore)"
}

htmldjango.formatting.providerstring

Provider for formatting. Possible options include 'djlint', 'djhtml' and 'none'

Default: "djlint"

Raw JSON Schema

{
  "enum": [
    "djlint",
    "djhtml",
    "none"
  ],
  "type": "string",
  "default": "djlint",
  "description": "Provider for formatting. Possible options include 'djlint', 'djhtml' and 'none'"
}

htmldjango.djlint.addLinterArgsarray

Additional arguments passed to djlint linter

Default: []

Raw JSON Schema

{
  "type": "array",
  "items": {
    "type": "string"
  },
  "default": [],
  "description": "Additional arguments passed to djlint linter"
}

htmldjango.djlint.addFormatterArgsarray

Additional arguments passed to djlint formatter

Default: []

Raw JSON Schema

{
  "type": "array",
  "items": {
    "type": "string"
  },
  "default": [],
  "description": "Additional arguments passed to djlint formatter"
}

htmldjango.djlint.preserveBlankLinesboolean

Attempt to preserve blank lines (--preserve-blank-lines)

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "default": false,
  "description": "Attempt to preserve blank lines (--preserve-blank-lines)"
}

htmldjango.djlint.preserveLeadingSpaceboolean

Attempt to preserve leading space on text (--preserve-leading-space)

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "default": false,
  "description": "Attempt to preserve leading space on text (--preserve-leading-space)"
}

coc-htmldjango

Published Package Summary

coc-htmldjango

Features

Install

Tool (linter & formatter) detection

Code Actions

Bult-in install (djLint, DjHTML)

Thanks

License

Version History

Contributed Commands

Configuration Schema