Python Markdown On-Page SEO

Python Markdown On-Page SEO is a CLI utility that analyzes Markdown files before publication to ensure they meet standard SEO best practices. It bridges the gap for developers using static site generators who miss the real-time SEO feedback of platforms like WordPress.

Why I Built This

After moving away from WordPress, I lost access to content analysis tools like RankMath. While existing tools check live sites, I needed a tool to analyze raw content pre-publication. I built this script to scan my Markdown files and flag SEO improvements before deploying.

Key Features

• Flexible Parsing: Supports raw Markdown or files with YAML front matter.
• Smart Defaults: Automatically infers titles from the first H1 tag and descriptions from the first 160 characters of the initial paragraph (or accepts custom CLI overrides).
• Comprehensive SEO Audit: Generates structured terminal reports covering:
  • Title and meta description length/keyword placement.
  • Word count and keyword density metrics.
  • Internal/external link counts.
  • Content hierarchy analysis (e.g., checking H2 headings for focus keywords).

Tech Stack & Usage

Core: Python 3, BeautifulSoup4, Markdown 3.3.4