AI agents prefer clean markdown over HTML. Here’s how to serve both from a Jekyll blog.

Josh Hornby

AI agents struggle to extract content from HTML-heavy webpages. This post demonstrates how to serve markdown versions of blog posts alongside HTML using Jekyll and GitHub Pages. The implementation involves adding a link tag with rel="alternate" to point to markdown files, and using a GitHub Actions workflow to copy markdown source files to match post URLs. This approach gives AI agents direct access to clean, structured content without requiring them to parse HTML, similar to how RSS feeds serve a different format for feed readers.

Serving Markdown for AI Agents