Skip to content

v2.0.3 - AI-Optimized Markdown Output

Choose a tag to compare

View all tags
@spcaeo spcaeo released this 21 Jan 17:35
· 147 commits to main since this release
v2.0.3
fb6b718

🎯 Critical Fixes for AI-Friendly Markdown (Issue #9)

This release addresses fundamental issues with markdown conversion that prevented AI agents from receiving clean, semantic content.

What's Fixed

1. Pure Markdown Output ✅

  • Before: HTML tags mixed with markdown
  • After: All HTML stripped, pure markdown syntax only
  • Changed strip_tags => true in converter configuration

2. Main Content Extraction ✅

  • Before: Entire page HTML (navigation, forms, sidebars, comments)
  • After: Only main article content extracted
  • New intelligent detection:
    • Strategy 1: Look for <article> tag (HTML5 semantic)
    • Strategy 2: WordPress content classes (.entry-content, .post-content, etc.)
    • Strategy 3: <main> tag detection
    • Strategy 4: Fallback removal of UI chrome

3. What Gets Removed ❌

The converter now strips all UI chrome that AI agents don't need:

  • Navigation menus
  • Headers and footers
  • Sidebars and widgets
  • Contact forms
  • Comments sections
  • Related posts
  • All elements with classes/IDs: sidebar, menu, nav, footer, header, widget

4. Enhanced Table Support 📊

  • Added table pipe escaping
  • Proper markdown table formatting
  • Clean table output for structured data

Testing

Comprehensive local testing on Docker WordPress:

  • ✅ Pure markdown output (no HTML tags)
  • ✅ Main content only (no sidebars/navigation)
  • ✅ Clean frontmatter with metadata
  • ✅ Homepage and post markdown verified
  • ✅ Screenshots included in testing

Why This Matters

The Third Audience philosophy:

  • First Audience: Humans (need full UI - navigation, forms, CTAs)
  • Second Audience: Search engines (need structured HTML for SEO)
  • Third Audience: AI agents (need clean, semantic markdown)

AI agents (ClaudeBot, GPTBot, PerplexityBot) need focused content without UI noise. This release delivers exactly that.

Files Changed

  • includes/class-ta-local-converter.php - Complete rewrite of content extraction
  • third-audience.php - Version bump to 2.0.3

Upgrade Notes

No breaking changes. Simply update and clear cache to regenerate all markdown files with the new clean format.

Related: Issue #9 - AI-Optimized Markdown Content Enhancements

Assets 2
Loading