Use Case

MDX SEO Validator

An MDX linter for SEO. Validate meta tags, schema markup, and keyword placement across your MDX and Markdown content. Catch issues before they ship — with MDX preview in VS Code, Cursor, or any MCP-compatible editor.

Get Started See what it checks

MDX SEO is hard without the right tools

When you write content in MDX or Markdown, there's no CMS checking your mdx meta tags, generating your schema, or warning you about missing descriptions. Every page is a file in your repo, and SEO validation is on you.

You ship a blog post with a 15-character description. You forget og:image on a landing page. You write 2,000 words without mentioning your target keyword in the first paragraph. These are invisible problems until you check Google Search Console weeks later and wonder why nobody found your content.

An MDX SEO validator catches these before deploy — like an mdx linter for your content's search performance.

What the MDX validator checks

Every check runs against your actual MDX files — frontmatter, content, and rendered output.

MDX meta tags & frontmatter

Validates title, description, og:image, twitter:card, and canonical URL in your MDX frontmatter. Flags missing or too-short mdx meta tags.

Schema markup

Checks for valid JSON-LD structured data — BlogPosting, Article, FAQ, HowTo. Verifies required fields match your content.

Keyword placement

Audits keyword density and placement against your target keywords. Checks H1, first paragraph, subheadings, and meta description.

Heading structure

Validates H1/H2/H3 hierarchy. Catches duplicate H1s, skipped levels, and headings that don't include target keywords.

Image alt text

Finds images missing alt attributes. Suggests keyword-relevant alt text based on surrounding content.

Internal links

Detects broken internal links, orphaned pages, and missing cross-references between related content.

What it looks like

Ask your AI to validate an MDX file. It scans the content and tells you exactly what to fix.

You

Scan my latest blog post at /blog/ai-seo-tools for SEO issues before I merge this PR.

Claude (using scan_page, optimize_content)

I scanned the MDX file. Found 4 issues:

errorMeta description is 12 characters — minimum 120 recommended

errorNo schema markup found — BlogPosting recommended for blog posts

warnTarget keyword “ai seo tools” missing from first paragraph

warn2 images missing alt attributes

I can fix all of these. Want me to update the frontmatter, add schema, and adjust the content?

You

Yes, fix all of them.

Claude (editing blog/ai-seo-tools/page.mdx)

- description: "AI SEO tools"

+ description: "Compare the best AI SEO tools for automated site audits, keyword research, and content optimization. Hands-on review with real results."

All 4 issues fixed. Meta description expanded, BlogPosting schema added, keyword placed in the intro paragraph, and alt text generated for both images. Changes are staged.

Three ways to validate

Pick the one that fits your workflow. They all use the same validation engine.

MDX preview in VS Code

Install the Rampify extension for VS Code or Cursor. Get an MDX preview with SEO validation in the sidebar — see issues as you write, not after you deploy.

Extensions > “Rampify” > Install