A linter for Markdown blog posts based on Why Content Linting Matters: QA for the GenAI Era. It checks for technical SEO, keyword usage, link health, headings, images, spelling, and readability. The linter can run locally as a CLI tool or inside GitHub Actions.
pip install .
content-linter --posts-dir _posts --keywords-file .github/scripts/keywords.txtThe command exits with a non-zero status if any check fails, including spelling and readability.
- uses: razkpp/content-linter@v0
with:
keywords-file: .github/scripts/keywords.txtThe linter now ensures each post's front matter provides a title, slug, and non-empty description. Missing titles or descriptions trigger errors, and successful checks note the detected values.
- Initial release of the Content Linter GitHub Action.
- Technical SEO validation: Checks for titles, descriptions, and images.
- Keyword validation: Ensures relevant keywords are present.
- Spell check: Detects and corrects spelling errors.
- Easy integration with GitHub workflows.
- Added recommendations for internal and external links.
- Added recommendations for including at least one image.
- Improved error and warning messages.
- Spell check now suggests corrections for misspelled words.
I'm a hands-on, data-driven marketer with 8+ years in early-stage startups, blending strategy with execution. I help technical founders build and scale their go-to-market (GTM) foundations, making them growth-ready through a mix of modern marketing, AI-powered automation, and data-driven insights.
I run a boutique GTM service tailored for B2B startups beyond stealth mode. I specialize in:
- GTM Strategy & Execution – From zero to a scalable marketing engine
- Marketing Infrastructure – Tools, automation, and AI-powered workflows
- Competitor & Market Analysis – Data-backed insights for positioning and growth
- Content & Messaging Frameworks – PLG, partner-led, founder-led, or outbound growth
🚀 Let's talk if you're a B2B startup founder looking to build a scalable marketing foundation!