@aggreggator-labs/config-markdownlint
v0.0.2
Published
Shared markdownlint ruleset for aggreggator-labs repositories - extend it from a repo-local .markdownlint-cli2 config
Maintainers
Readme
@aggreggator-labs/config-markdownlint
The shared markdownlint rules for aggreggator-labs repositories.
index.json is the source of truth; the stowed machine config in
dotfiles is generated from it and a test keeps the two in sync.
Usage
bun add -d @aggreggator-labs/config-markdownlint markdownlint-cli2Root .markdownlint-cli2.yaml:
config:
extends: '@aggreggator-labs/config-markdownlint'
ignores:
- '**/node_modules/**'Only the rules are shared; ignores are each repository's own.
Editor extension, CLI and CI discover the root file and report
the same findings.
Rules
Deviations from the markdownlint defaults; everything else is default:
MD009strict — no trailing spaces, not even in list continuation linesMD013off — no line-length limit; Prettier owns wrappingMD024siblings only — duplicate headings flagged only among siblingsMD033off — inline HTML allowedMD040off — code fences need no languageMD041off — a file need not start with a heading
Publishing
Releases are staged, never pushed live by a machine. A push to
main with a new version in package.json runs
.github/workflows/publish-npm.yml in the dotfiles repository,
which stages the version on npmjs through trusted publishing
(GitHub OIDC, no token; no provenance, which npm attaches only
for public source repositories). A maintainer then approves it
with two-factor authentication — npm stage approve or the
package page — and only then is it on the registry. An unchanged
version stages nothing and says so. Bump the version here to
release; patch bumps (0.0.x) by default.
