Markuplintとは？HTML・ARIA・framework templateを検査するmarkup linter

ページ内ナビ

概要

Markuplintは、HTMLや各種templateを検査するmarkup linterです。HTML Standard、WAI-ARIA、ARIA in HTML等に基づくruleを適用でき、JSX、Vue、Svelte、Astro、Pug、PHPなどはparser/spec packageを組み合わせて解析できます。CLIとVS Code extensionを提供します。

特徴と向いている用途

公式資料に基づく紹介・実機未検証 · 内容確認日：2026-09-30

主な特徴

HTML構造・属性・ARIAをruleで検査する

HTML specificationに基づき、element・attribute・ARIA等の違反をCLIから検出します。ruleはconfigurationで選択でき、CSS selectorを使ってelement単位に適用範囲を変えることもできます。

出典：[2]

frameworkやtemplate engineごとにparserを切り替える

JSX、Vue、Svelte、Astro、Alpine.js、Pug、PHP等のparser/spec packageを用意し、純粋なHTML以外のtemplate syntaxもproject構成に合わせて検査できます。

出典：[2]

向いている用途

markup品質とaccessibility上の基本的な違反をCIで継続検査したい場合に向く

HTMLやcomponent templateのrule違反をlocal CLI、npm script、editor、CIで同じ設定から検出したいfrontend projectに向きます。

出典：[2]

導入前の確認

v5.0.1はNode.js 24以上を要求する

v5.0.1のpackage metadataとREADMEはNode.js 24.0.0以上を要求します。既存CIや開発端末のNode versionを確認してからupgradeします。

出典：[2][3]

framework directiveと通常HTML属性を同一視しない

v5.0.1ではno-event-handler-attrがVue、Alpine.js、htmx、Svelte等のframework event directiveを誤検出しないよう修正されました。framework利用時は対応parser/specを正しく設定することが重要です。

出典：[4]

参考にした公式資料

[1]markuplint repository(2026-09-30)
[2]markuplint package README(2026-09-30)
[3]markuplint v5.0.1 package metadata(2026-09-30)
[4]markuplint v5.0.1 release(2026-09-30)
[5]markuplint MIT license(2026-09-30)

編集部からの補足

HTMLだけでなくframework templateまで同じmarkup policyで検査できる点が特徴です。v5ではNode.js 24+が必要なため、lint導入だけでCI runtime更新が必要になるprojectでは先に影響範囲を確認してください。

3ステップで試す

1
対話式に初期設定
必要なparserやspecを質問に答えながら追加します。v5.0.1はNode.js 24以上が必要です。
npx markuplint@5.0.1 --init
2
HTMLをlint
まずplain HTMLを対象にrule違反を確認します。framework templateでは初期設定で選んだparser/specを使います。
npx markuplint@5.0.1 "src/**/*.html"
3
CI用scriptへ固定
package.jsonのscriptsへ追加し、localとCIで同じconfigurationを使って継続検査します。
"lint:html": "markuplint "src/**/*.html""

公式READMEで確認

成長

成長の推移 · 直近30日

619 Stars

推移データを蓄積中です。

Built with

カテゴリとタグ

GitHubデータ

GitHubのデータGitHubの詳細データを見る

GitHubで見る

GitHub Topics

alpinejs
custom-elements
html
htmx
jsx-templates
linter
liquid
mustache-templates
nunjucks
php
pug
react

Stars: 619
Forks: 63
Watchers: 2
Open Issues: 41
所有者種別: Organization
主要言語: TypeScript
ライセンス: MIT
リポジトリ最終更新: 2026/09/29

概要

特徴と向いている用途

主な特徴

HTML構造・属性・ARIAをruleで検査する

frameworkやtemplate engineごとにparserを切り替える

向いている用途

markup品質とaccessibility上の基本的な違反をCIで継続検査したい場合に向く

導入前の確認

v5.0.1はNode.js 24以上を要求する

framework directiveと通常HTML属性を同一視しない

参考にした公式資料

3ステップで試す

対話式に初期設定

HTMLをlint

CI用scriptへ固定

成長

Built with

カテゴリとタグ

カテゴリ

タグ

GitHubデータ

GitHub Topics

関連情報

あわせて探訪