{"id":38668,"date":"2026-03-03T15:12:35","date_gmt":"2026-03-03T15:12:35","guid":{"rendered":"https:\/\/make.wordpress.org\/meta\/?p=38668"},"modified":"2026-03-03T15:12:35","modified_gmt":"2026-03-03T15:12:35","slug":"markdown-now-available-on-wordpress-org","status":"publish","type":"post","link":"https:\/\/make.wordpress.org\/meta\/2026\/03\/03\/markdown-now-available-on-wordpress-org\/","title":{"rendered":"Markdown now available on WordPress.org"},"content":{"rendered":"

Most WordPress.orgWordPress.org<\/span> The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https:\/\/wordpress.org\/<\/a><\/span><\/span><\/span> sites now support Markdown output. Simply send Accept: text\/markdown<\/code> or append ?output_format=md<\/code> to any URLURL<\/span> A specific web address of a website or web page on the Internet, such as a website\u2019s URL www.wordpress.org<\/span><\/span><\/span>.<\/p>\n\n\n\n

This is also linked in the <head><\/code> via a <link rel=\"alternate\" type=\"text\/markdown\"><\/code> tag for auto-discovery.<\/p>\n\n\n\n

What does it look like? Here\u2019s the get_permalink()<\/code> documentation as an example:<\/p>\n\n\n\n

$ curl -sH 'Accept: text\/markdown' https:\/\/developer.wordpress.org\/reference\/functions\/get_permalink\/ | head\nTitle: get_permalink\nPublished: April 25, 2014\nLast modified: February 24, 2026\n\n---\n\n# get_permalink( int|WP_Post\u00a0$post, bool\u00a0$leavename\u00a0=\u00a0false\u00a0): string|false\n\n## In this article\n\n * [Parameters](https:\/\/developer.wordpress.org\/reference\/functions\/get_permalink\/#parameters)\n * [Return](https:\/\/developer.wordpress.org\/reference\/functions\/get_permalink\/#return)\n * [More Information](https:\/\/developer.wordpress.org\/reference\/functions\/get_permalink\/#more-information)\n * [Source](https:\/\/developer.wordpress.org\/reference\/functions\/get_permalink\/#source)\n * [Hooks](https:\/\/developer.wordpress.org\/reference\/functions\/get_permalink\/#hooks)<\/code><\/pre>\n\n\n\n
Why?<\/h2>\n\n\n\n
For years, WordPress.org content and documentation has been available in many different languages<\/a> \u2014 but there\u2019s an increasingly important new consumer of information: AI agents and large language models.<\/p>\n\n\n\n
These systems learn from documentation across the web. By offering WordPress.org content in clean, structured Markdown, we make it easier for them to understand WordPress in their native format, and we establish WordPress.org as a canonical knowledge source. This helps ensure that when AI tools learn about WordPress, they\u2019re learning from accurate, up-to-date, official content \u2014 not outdated or third-party interpretations.<\/p>\n\n\n\n
How?<\/h2>\n\n\n\n
We\u2019re using an excellent pluginPlugin<\/span> A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https:\/\/wordpress.org\/plugins\/<\/a> or can be cost-based plugin from a third-party.<\/span><\/span><\/span>, html-to-md<\/a> by Dennis Snell<\/a> that converts HTMLHTML<\/span> HTML is an acronym for Hyper Text Markup Language. It is a markup language that is used in the development of web pages and websites.<\/span><\/span><\/span> to Markdown on-the-fly.<\/p>\n\n\n\n
What\u2019s next?<\/strong><\/h2>\n\n\n\n
We\u2019d love to see what you build with this. Beyond AI tooling, Markdown output opens up possibilities like referencing documentation from the terminal, presenting it in a different format, or creating live custom integrated documentation for your favorite code editor.<\/p>\n\n\n\n
Give it a try \u2014 experiment with the output, build something cool, and let us know how you\u2019re using it in the comments.<\/p>\n\n\n\n
Found a bug?<\/h2>\n\n\n\n
Since we\u2019re converting HTML to Markdown, not all content translates equally well \u2014 WordPress.org profiles are one such example.<\/p>\n\n\n\n
If you find content that isn\u2019t parsing correctly, please leave a comment below or file an issue on the GitHub repository<\/a>, and we\u2019ll see what we can do.<\/p>\n