Analisador SEO de Markdown

Analyzing Markdown Content for SEO Best Practices

Content-heavy sites built with static site generators (Astro, Next.js, Hugo, Jekyll) store articles as Markdown files. SEO optimization for these pages happens at the content level — heading hierarchy, internal link density, image alt text, keyword placement, and readability all determine search ranking potential. The Markdown SEO Analyzer evaluates your Markdown content against on-page SEO best practices, providing a quality score with actionable recommendations for improving search visibility without leaving your writing workflow.

Paste your Markdown content (including optional YAML frontmatter) to receive analysis of heading structure, link quality, image accessibility, readability metrics, keyword density, and metadata completeness. Each finding maps to a specific SEO factor with clear guidance on what to improve. All processing happens in your browser — your content never leaves your device.

Heading Structure Analysis

Search engines use headings to understand content hierarchy and topic organization:

• H1 presence: Every article should have exactly one H1 (the title) — many static generators derive H1 from frontmatter title
• Level skipping: Jumping from H2 to H4 (skipping H3) indicates poor structure and confuses crawlers
• Keyword in H1: The primary keyword should appear naturally in the page title
• H2 distribution: Content should be broken into scannable sections with descriptive H2/H3 headings
• Heading length: Excessively long headings (>70 chars) get truncated and lose impact

Link and Image Quality

Links and images contribute significantly to SEO performance:

• Internal links: Articles should link to related content on your site — 2-5 internal links per 1000 words is a healthy density
• External links: Citing authoritative external sources adds credibility
• Broken link indicators: Relative paths that may not resolve correctly
• Image alt text: Every image must have descriptive alt text for accessibility and image search indexing
• Image file names: Descriptive filenames (react-component-lifecycle.png) rank better than generic names (image1.png)

Readability and Content Quality Metrics

Content quality signals that correlate with search ranking:

• Word count: Long-form content (1500+ words) tends to rank better for competitive keywords
• Sentence length: Average sentences over 25 words reduce readability — aim for 15-20 words
• Paragraph length: Paragraphs exceeding 150 words should be broken into smaller blocks
• Keyword density: Primary keyword should appear naturally 1-3% of the time — over-optimization triggers spam signals
• Frontmatter completeness: Title, description, date, author, and canonical URL in YAML frontmatter

The analyzer calculates a composite SEO score from 0 to 100 based on weighted factors: heading structure (25%), content length and quality (25%), link density (20%), image optimization (15%), and metadata completeness (15%). Each factor maps directly to known Google ranking signals documented in SEO research and Google's own Search Central guidelines for content quality assessment.

Code Examples

Well-Optimized Markdown Article Structure

---
title: "Understanding React Server Components in 2024"
description: "A practical guide to React Server Components with examples"
date: 2024-03-15
author: "Dev Team"
canonical: "https://blog.example.com/react-server-components"
keywords: ["react", "server components", "RSC", "next.js"]
---

# Understanding React Server Components in 2024

React Server Components (RSC) fundamentally change how we think about...

## What Are Server Components?

Server Components render on the server and send HTML to the client...

## Benefits Over Traditional SSR

![React rendering pipeline](/images/react-rsc-pipeline.png)
*Alt: Diagram showing React Server Component rendering pipeline*

### Reduced Bundle Size

Server Components never ship JavaScript to the browser...

## Getting Started with RSC

See our [Next.js setup guide](/guides/nextjs-rsc-setup) for...

## Conclusion

Server Components represent the next evolution of React architecture...