katana-markdown-linter
v0.19.4
Published
Fast Markdown linter and formatter with localized CLI help and version aliases.
Maintainers
Readme
katana-markdown-linter
katana-markdown-linter is a thin launcher over GitHub Release binary
archives for npm. The package does not contain independent lint or MCP server
logic. On first use, it downloads the matching kml, kml-mcp, or kml-mcp-remote
binary archive, verifies the neighboring SHA-256 checksum, installs the binary
into the wrapper cache, and delegates to that binary.
Install
npm install -g katana-markdown-linter
kml --versionUse npx for one-off runs:
npx --yes [email protected] --version
npx --yes [email protected] check README.mdBasic Usage
# Run linting
kml check README.md
# Show help
kml help
kml --help
kml -h
kml check --help
# Localized help
kml --locale ja help
# Show version aliases
kml version
kml --version
kml -v
# Fix and Format
kml fix README.md
kml fmtMCP server entrypoints
Use kml-mcp for local stdio MCP clients:
npx --yes [email protected] kml-mcp --workspace-root /absolute/path/to/workspace
bunx --package [email protected] kml-mcp --workspace-root /absolute/path/to/workspace
npx --yes --package [email protected] kml-mcp --workspace-root /absolute/path/to/workspaceUse kml-mcp-remote only for self-hosted Streamable HTTP:
KML_MCP_REMOTE_TOKEN=change-me \
npx --yes --package [email protected] kml-mcp-remoteSupported Platforms
The npm launcher uses the same binary archives as the GitHub Release channel. It currently supports:
- macOS arm64:
aarch64-apple-darwin - macOS x64:
x86_64-apple-darwin - Linux x64:
x86_64-unknown-linux-gnu - Windows x64:
x86_64-pc-windows-msvc
Unsupported platforms fail before download with an explicit platform error.
Wrapper Contract
- The package version selects the GitHub Release tag.
- The launcher downloads the matching
kml-vX.Y.Z-<target>,kml-mcp-vX.Y.Z-<target>, orkml-mcp-remote-vX.Y.Z-<target>archive. - The launcher downloads the matching
.sha256file and verifies the archive before extraction. - The installed binary is cached by version, platform, and executable role.
- MCP launchers do not write wrapper logs to stdout, preserving JSON-RPC stdio.
For full CLI usage, rule coverage, and other install channels, see the repository README. Report package issues through GitHub Issues.
