Registry / serialization / micromark-util-html-tag-name

micromark-util-html-tag-name

library2.0.1jsnpmunverified

micromark-util-html-tag-name is a low-level utility package within the `micromark` ecosystem, providing curated lists of HTML tag names relevant for CommonMark-compliant Markdown parsing. Specifically, it exports `htmlBlockNames` and `htmlRawNames`, which are used by `micromark` to apply specific parsing rules for HTML (flow) constructs. The `htmlBlockNames` array aids in determining when more relaxed parsing rules apply, based on CommonMark's condition 6, while `htmlRawNames` guides the parser on when HTML content can include lines without exiting until a matching closing tag is found (CommonMark's condition 1). This package is currently in its stable version 2.0.1 and is actively maintained as part of the `micromark` monorepo, which generally sees frequent updates, often with performance enhancements, and drops support for unmaintained Node.js versions with new major releases. It's designed for developers building or extending `micromark` itself, rather than for general HTML tag lookup.

serialization

npm install micromark-util-html-tag-name

github ↗package ↗

INSTALL

IMPORT

SIG · MICROMARK-UTIL-HTM

micromark-util-html-tag-name

serializationjavascriptv2.0.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

htmlBlockNames

✓ import { htmlBlockNames } from 'micromark-util-html-tag-name'

✗ const htmlBlockNames = require('micromark-util-html-tag-name').htmlBlockNames

This package is ESM-only since v2, requiring ES module import syntax. Attempting CommonJS `require` will result in an error.

htmlRawNames

✓ import { htmlRawNames } from 'micromark-util-html-tag-name'

✗ const htmlRawNames = require('micromark-util-html-tag-name').htmlRawNames

This package is ESM-only since v2, requiring ES module import syntax. Attempting CommonJS `require` will result in an error.

all tag names

✓ import { htmlBlockNames, htmlRawNames } from 'micromark-util-html-tag-name'

✗ import htmlTagNames from 'micromark-util-html-tag-name'

There is no default export from this module; all exports are named. Attempting to import a default will result in a runtime error.

This quickstart demonstrates how to import and access the `htmlBlockNames` and `htmlRawNames` arrays, detailing their purpose within the micromark parser's logic for handling HTML tags based on CommonMark specifications.

import { htmlBlockNames, htmlRawNames } from 'micromark-util-html-tag-name'; console.log('--- HTML Block Names (CommonMark Condition 6) ---'); console.log('These tags allow more relaxed parsing rules within micromark.'); console.log('Examples:', htmlBlockNames.slice(0, 5).join(', ') + '...'); console.log(`Total block tags: ${htmlBlockNames.length}`); console.log('\n--- HTML Raw Names (CommonMark Condition 1) ---'); console.log('Content within these tags is treated as raw HTML, without further Markdown parsing, until a closing tag is found.'); console.log('Examples:', htmlRawNames.slice(0, 3).join(', ') + '...'); console.log(`Total raw tags: ${htmlRawNames.length}`); // This utility package primarily provides these lists for use within the micromark parser. // It is not intended for general-purpose HTML tag validation or manipulation outside of micromark's context. // Developers building custom micromark extensions or alternatives might directly consume these lists.

Debug

Known issues

breakingThis package is ESM-only since its v2 release. Projects must use ES module import syntax (`import`) and a Node.js version that supports ESM.

fix

Migrate your project to use ES modules and ensure Node.js 16+ is used. Replace `require()` calls with `import` statements.

affects: >=2.0.0

breakingMajor versions of `micromark` packages, including this utility, drop support for unmaintained Node.js versions. Version 2.x requires Node.js 16 or higher.

fix

Upgrade your Node.js environment to a currently maintained version (e.g., Node.js 16+ for v2.x).

affects: >=2.0.0

gotchaThe exported lists (`htmlBlockNames`, `htmlRawNames`) are specific to `micromark`'s CommonMark parsing implementation. They are not intended as general-purpose, exhaustive lists for all HTML tags or for arbitrary HTML validation/manipulation.

fix

Understand that these lists reflect CommonMark specifications for Markdown parsing, not general HTML standards. Consult HTML specifications or dedicated HTML parsing libraries for broader use cases.

affects: >=1.0.0

gotchaThe contents of `htmlBlockNames` and `htmlRawNames` can change with updates to the CommonMark specification. For example, 'search' was added to `htmlBlockNames` in CommonMark@0.31, and 'textarea' was added to `htmlRawNames` in CommonMark@0.30.

fix

Be aware that new CommonMark versions may introduce or remove tags from these lists. If you're building custom extensions, ensure compatibility with the CommonMark version `micromark` targets.

affects: >=1.0.0

Errors

Common errors & fixes

TypeError: require is not a function

Attempting to import the ESM-only package using CommonJS `require()` syntax.

fix

Update your import statement to `import { htmlBlockNames, htmlRawNames } from 'micromark-util-html-tag-name';` and ensure your environment supports ES modules.

SyntaxError: Named export 'htmlTagNames' not found. The requested module 'micromark-util-html-tag-name' does not provide an export named 'htmlTagNames'

Incorrectly trying to import a non-existent default export or an aggregation that doesn't exist.

fix

Correct the import to explicitly use the named exports `htmlBlockNames` and `htmlRawNames`: `import { htmlBlockNames, htmlRawNames } from 'micromark-util-html-tag-name';`.

Upgrade

Version history

2.0.1latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/micromark/micromark.git#main ↗

packagehttps://www.npmjs.com/package/micromark-util-html-tag-name ↗