GTM Toolkit

Developer-Native Marketing

`gtm-toolkit lint`

Run SEO linting and content-quality checks against markdown or MDX files with configurable severity.

Usage
Point the command to a directory or file
# Lint the entire blog directory
npx gtm-toolkit lint content/blog
Output Formats
Choose the reporting style that matches your workflow
--format console
Colorized CLI output (default)
--format json
Structured JSON for CI pipelines
Rule Coverage
SEO-000 to SEO-099 grouped into practical categories
  • • Frontmatter: titles, summaries, canonical URLs, categories.
  • • Content structure: heading order, keyword placement, paragraph length.
  • • Media checks: missing alt attributes and unsupported image formats.
  • • Technical: slug/date mismatches, broken internal links, draft flags.
Failing Builds
Let linting block deploys when critical SEO rules fail
# Exit with non-zero when errors are found
npx gtm-toolkit lint content/blog --fail-on-error

The CLI exits with status code 1 only when rules marked as errors fail. Warnings still surface in the report but do not block deployments.