coc-html

Neoclide CI passing

Html extension for coc.nvim

Installation CommandVim prompt

:CocInstall coc-html

GitHub owner

Neoclide

Version

v1.9.2

npm package

coc-html

Requirements

coc ^0.0.80

License

MIT

Repository

GitHub

npm latest published 2026-10-11Node >=22Registry summary

Try in browser ↗

Published Package Summary

coc-html

Html language server extension for coc.nvim.

Code changed from html extension of VSCode

Install

In your vim/neovim, run command:

:CocInstall coc-html

Features

Completion provider
Formatting
Document Symbols & Highlights
Document Links
CSS mode
Javascript mode

F.A.Q

Q: I can't select the complete item by <C-n> and <C-p>

A: Some completion item requires insert position after current cursor position which is invalid for <C-n> and <C-p> on vim, you can use <up> and <down> key for selection, or use api coc#_select_confirm() to select and confirm selection which is recommended.

Development

Use Node.js 22.15 or newer and npm 11.9.0. Install dependencies from the committed npm lockfile, then build and validate:

npm ci
npm run build
npm run lint
npm test

The integration tests run both Neovim and Vim; both editors must be installed.

License

MIT

Read the complete README

Html extension for coc.nvim

Activation Events

Developer Resources

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

Open Developer Guide

Published with coc-html@1.9.2 as history.md.

Open source file

1.9.2

fix: update coc-test for authenticated release downloads (#66) (e13cf24)
ci: not download coc.nvim (4be348c)

1.9.1

ci: add daily automated release workflow (e8bb2cc)
docs: remove upstream sync ledger (1f1450a)
chore: standardize npm and shared dependency versions (#65) (bf3e52f)
Merge pull request #64 from neoclide/codex/upstream-sync-20261003 (b056e89)
chore: sync documentation branch with merged HTML changes (d946aed)
Update coc-html (b4ccf68)
feat: sync upstream HTML and CSS language services (#63) (21bbc07)
docs: clarify local upstream baseline provenance (eb1ae3d)
feat: sync upstream HTML and CSS language services (7e585d6)

1.9.0

Sync the HTML and embedded CSS language services with VS Code's September 2026 versions while retaining the Coc server bundle and settings.
Require Node.js 22 and migrate development and CI workflows to npm.
Improve embedded CSS and JavaScript handling, including isolated validation for module scripts.
Include JSDoc summaries and tags in JavaScript hover content.
Improve language-server activation recovery and automatic-insertion cleanup.
Add Vim and Neovim integration tests.

1.8.0

Remove configuration html.format.endWithNewline>
Remove configuration html.validate.html.
Remove configuration html.enable.
Check format configuration before register formatter provider.

All contributes.commands entries from the published package manifest for coc-html@1.9.2.

This package does not declare any contributed commands.

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

html.execArgvarray

Default: []

Raw JSON Schema

{
  "type": "array",
  "items": {
    "type": "string"
  },
  "default": []
}

html.filetypesarray

Default: ["html","handlebars","htmldjango","blade"]

Raw JSON Schema

{
  "type": "array",
  "items": {
    "type": "string"
  },
  "default": [
    "html",
    "handlebars",
    "htmldjango",
    "blade"
  ]
}

html.customDataarray

A list of relative file paths pointing to JSON files following the [custom data format](https://github.com/microsoft/vscode-html-languageservice/blob/master/docs/customData.md). coc-html loads custom data on startup to enhance its HTML support for the custom HTML tags, attributes and attribute values you specify in the JSON files. The file paths are relative to workspace and only workspace folder settings are considered.

Default: []

Raw JSON Schema

{
  "type": "array",
  "items": {
    "type": "string"
  },
  "scope": "resource",
  "default": [],
  "markdownDescription": "A list of relative file paths pointing to JSON files following the [custom data format](https://github.com/microsoft/vscode-html-languageservice/blob/master/docs/customData.md).\n\ncoc-html loads custom data on startup to enhance its HTML support for the custom HTML tags, attributes and attribute values you specify in the JSON files.\n\nThe file paths are relative to workspace and only workspace folder settings are considered."
}

html.trace.serverstring

Traces the communication between coc.nvim and the HTML language server

Default: "off"

Raw JSON Schema

{
  "enum": [
    "off",
    "messages",
    "verbose"
  ],
  "type": "string",
  "default": "off",
  "description": "Traces the communication between coc.nvim and the HTML language server"
}

html.format.enableboolean

Enable/disable default HTML formatter

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "scope": "window",
  "default": true,
  "description": "Enable/disable default HTML formatter"
}

html.suggest.html5boolean

Configures if the built-in HTML language support suggests HTML5 tags, properties and values

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "scope": "resource",
  "default": true,
  "description": "Configures if the built-in HTML language support suggests HTML5 tags, properties and values"
}

html.autoClosingTagsboolean

Enable/disable autoClosing of HTML tags

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "default": true,
  "description": "Enable/disable autoClosing of HTML tags"
}

html.validate.stylesboolean

Configures if the built-in HTML language support validates embedded styles

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "scope": "resource",
  "default": true,
  "description": "Configures if the built-in HTML language support validates embedded styles"
}

html.autoCreateQuotesboolean

Enable/disable auto creation of quotes for HTML attribute assignment.

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "scope": "resource",
  "default": true,
  "description": "Enable/disable auto creation of quotes for HTML attribute assignment."
}

html.hover.referencesboolean

Show references to MDN in hover

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "scope": "resource",
  "default": true,
  "description": "Show references to MDN in hover"
}

html.validate.scriptsboolean

Configures if the built-in HTML language support validates embedded scripts

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "scope": "resource",
  "default": true,
  "description": "Configures if the built-in HTML language support validates embedded scripts"
}

html.format.templatingboolean

Honor django, erb, handlebars and php templating language tags

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "scope": "resource",
  "default": false,
  "description": "Honor django, erb, handlebars and php templating language tags"
}

html.format.extraLinersstring | null

List of tags, comma separated, that should have an extra newline before them. `null` defaults to `"head, body, /html"`

Default: "head, body, /html"

Raw JSON Schema

{
  "type": [
    "string",
    "null"
  ],
  "scope": "resource",
  "default": "head, body, /html",
  "markdownDescription": "List of tags, comma separated, that should have an extra newline before them. `null` defaults to `\"head, body, /html\"`"
}

html.format.unformattedstring | null

List of tags, comma separated, that shouldn't be reformatted. 'null' defaults to all tags listed at https://www.w3.org/TR/html5/dom.html#phrasing-content

Default: "wbr"

Raw JSON Schema

{
  "type": [
    "string",
    "null"
  ],
  "scope": "resource",
  "default": "wbr",
  "description": "List of tags, comma separated, that shouldn't be reformatted. 'null' defaults to all tags listed at https://www.w3.org/TR/html5/dom.html#phrasing-content"
}

html.hover.documentationboolean

Show tag and attribute documentation in hover

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "scope": "resource",
  "default": true,
  "description": "Show tag and attribute documentation in hover"
}

html.format.wrapAttributesstring

Wrap attributes

Default: "auto"

Raw JSON Schema

{
  "enum": [
    "auto",
    "force",
    "force-aligned",
    "force-expand-multiline",
    "aligned-multiple",
    "preserve",
    "preserve-aligned"
  ],
  "type": "string",
  "scope": "resource",
  "default": "auto",
  "description": "Wrap attributes",
  "enumDescriptions": [
    "Wrap attributes only when line length is exceeded",
    "Wrap each attribute except first",
    "Wrap each attribute except first and keep aligned",
    "Wrap each attribute",
    "Wrap when line length is exceeded, align attributes vertically",
    "Preserve wrapping of attributes",
    "Preserve wrapping of attributes but align"
  ]
}

html.format.wrapLineLengthinteger

Maximum amount of characters per line (0 = disable)

Default: 120

Raw JSON Schema

{
  "type": "integer",
  "scope": "resource",
  "default": 120,
  "description": "Maximum amount of characters per line (0 = disable)"
}

html.format.indentInnerHtmlboolean

Indent `<head>` and `<body>` sections

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "scope": "resource",
  "default": false,
  "markdownDescription": "Indent `<head>` and `<body>` sections"
}

html.format.indentHandlebarsboolean

Format and indent `{{#foo}}` and `{{/foo}}`

Default: false

Raw JSON Schema

{
  "type": "boolean",
  "scope": "resource",
  "default": false,
  "markdownDescription": "Format and indent `{{#foo}}` and `{{/foo}}`"
}

html.format.preserveNewLinesboolean

Controls whether existing line breaks before elements should be preserved. Only works before elements, not inside tags or for text

Default: true

Raw JSON Schema

{
  "type": "boolean",
  "scope": "resource",
  "default": true,
  "description": "Controls whether existing line breaks before elements should be preserved. Only works before elements, not inside tags or for text"
}

html.format.contentUnformattedstring | null

List of tags, comma separated, where the content shouldn't be reformatted. 'null' defaults to the 'pre' tag

Default: "pre,code,textarea"

Raw JSON Schema

{
  "type": [
    "string",
    "null"
  ],
  "scope": "resource",
  "default": "pre,code,textarea",
  "description": "List of tags, comma separated, where the content shouldn't be reformatted. 'null' defaults to the 'pre' tag"
}

html.format.maxPreserveNewLinesnumber | null

Maximum number of line breaks to be preserved in one chunk. Use `null` for unlimited

Default: null

Raw JSON Schema

{
  "type": [
    "number",
    "null"
  ],
  "scope": "resource",
  "default": null,
  "markdownDescription": "Maximum number of line breaks to be preserved in one chunk. Use `null` for unlimited"
}

html.format.wrapAttributesIndentSizenumber | null

Alignment size when using 'force aligned' and 'aligned multiple' in `#html.format.wrapAttributes#` or `null` to use the default indent size

Default: null

Raw JSON Schema

{
  "type": [
    "number",
    "null"
  ],
  "scope": "resource",
  "default": null,
  "markdownDescription": "Alignment size when using 'force aligned' and 'aligned multiple' in `#html.format.wrapAttributes#` or `null` to use the default indent size"
}

html.completion.attributeDefaultValuestring

Controls the default value for attributes when completion is accepted

Default: "doublequotes"

Raw JSON Schema

{
  "enum": [
    "doublequotes",
    "singlequotes",
    "empty"
  ],
  "type": "string",
  "scope": "resource",
  "default": "doublequotes",
  "description": "Controls the default value for attributes when completion is accepted",
  "enumDescriptions": [
    "Attribute value is set to \"\"",
    "Attribute value is set to ''",
    "Attribute value is not set"
  ]
}

html.format.unformattedContentDelimiterstring

Keep text content together between this string

Default: ""

Raw JSON Schema

{
  "type": "string",
  "scope": "resource",
  "default": "",
  "markdownDescription": "Keep text content together between this string"
}

coc-html

Published Package Summary

coc-html

Install

Features

F.A.Q

Development

License

Version History

1.9.2

1.9.1

1.9.0

1.8.0

Contributed Commands

Configuration Schema