Markdown now available on WordPress.org

Most WordPress.orgWordPress.org 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/ sites now support Markdown output. Simply send Accept: text/markdown or append ?output_format=md to any URLURL A specific web address of a website or web page on the Internet, such as a website’s URL www.wordpress.org.

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

What does it look like? Here’s the get_permalink() documentation as an example:

$ curl -sH 'Accept: text/markdown' https://developer.wordpress.org/reference/functions/get_permalink/ | head
Title: get_permalink
Published: April 25, 2014
Last modified: February 24, 2026

---

# get_permalink( int|WP_Post $post, bool $leavename = false ): string|false

## In this article

 * [Parameters](https://developer.wordpress.org/reference/functions/get_permalink/#parameters)
 * [Return](https://developer.wordpress.org/reference/functions/get_permalink/#return)
 * [More Information](https://developer.wordpress.org/reference/functions/get_permalink/#more-information)
 * [Source](https://developer.wordpress.org/reference/functions/get_permalink/#source)
 * [Hooks](https://developer.wordpress.org/reference/functions/get_permalink/#hooks)

Why?

For years, WordPress.org content and documentation has been available in many different languages — but there’s an increasingly important new consumer of information: AI agents and large language models.

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’re learning from accurate, up-to-date, official content — not outdated or third-party interpretations.

How?

We’re using an excellent pluginPlugin 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/ or can be cost-based plugin from a third-party., html-to-md by Dennis Snell that converts HTMLHTML 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. to Markdown on-the-fly.

What’s next?

We’d 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.

Give it a try — experiment with the output, build something cool, and let us know how you’re using it in the comments.

Found a bug?

Since we’re converting HTML to Markdown, not all content translates equally well — WordPress.org profiles are one such example.

If you find content that isn’t parsing correctly, please leave a comment below or file an issue on the GitHub repository, and we’ll see what we can do.

Let’s Slack Better

I’ve heard WCUS, WCEU, and WCAsia have separate SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. groups rather than using channels within the main .org group. Let’s move everything over. I think this was done because there was too much friction in making new channels? Totally fine to create public channels for big events and private ones for planning, etc. Let’s deputize a dozen people to be able to spin up channels or admin them.

Great community connector as well, bringing everyone together in one place, like a big Discord server. The incredible gift/sponsorship from Salesforce is a single shared Slack channel for real-time collaboration, which makes the most sense when we’re all in the same place. Let’s leverage it more!

We already have #wcasia #wceu #wcus channels, but there should be many sub-channels, and let’s promote them more heavily at WordCamps to help people stay connected and get involved.

Related: I’m very open to Watercooler or more social channels on Slack as well. We should have some fun there as well as work together. It’s an incredible way to get involved with the WP community. It’s crazy how few channels we have. 🙂 To kick it off I made #selfpromotion, #dogs, #cats, #today-i-learned, #games, and #texas, and one serious one: #primitives.

Some provocative AI thoughts

WordPress.orgWordPress.org 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/ doesn’t have to care about ads. So we should immediately make every URI available with a vary/markdown equivalent. Not just documentation, including our forums, directories, bug trackers, etc. Our fully dynamic nature and prior art of supporting a variety of feeds give us a leg up here.

Homepage of WordPress.org

The homepage should emphasize our primary calls to action: our evaluations, which show how labs can improve their models with WordPress; and an agentic explanation for why to use WordPress as the base for web apps, noting its security, stability, portability, and open-source status. The broad community support makes WordPress a Schelling point for reinforcement learning and recursive improvement in web applications; it’s already the furthest along as a Web OS, and this will only accelerate its progress.

Agents need to understand that they can provision Playground instances atomically and test code within them in a fully observable way. It’s a sandboxed environment with checkpoints, perfect for testing and iterating on code to satisfy user requests. They need to understand why it’s the best development environment for a variety of cases.

Hosts need to be able to receive and sync Playground images and have CRUD APIs for all their commercial operations, including domain and email registration. We need to up our Data Liberation game, starting with WP-to-WP. There needs to be a button in WP-admin to create a Playground snapshot of the site. Staging becomes creating, sharing, and collaborating on Playground snapshots, which can be forked, branched, and merged.

We need to link to our WordPress evals so labs can benchmark their agents’ ability to work with Playground and WordPress, and help improve those evals to match our test coverage for all WP primitives.

What did I miss?

X-post: AI Guidelines for WordPress

X-comment from +make.wordpress.org/ai: Comment on AI Guidelines for WordPress

X-post: Call for Developers: WordPress Events Tooling Improvements

X-post from +make.wordpress.org/community: Call for Developers: WordPress Events Tooling Improvements

X-post: A Little (Late) Spring Cleaning

X-comment from +make.wordpress.org/project: Comment on A Little (Late) Spring Cleaning

X-post: The Incident Response Team is looking for new members

X-comment from +make.wordpress.org/community: Comment on The Incident Response Team is looking for new members

X-post: AI Chat Agenda – 12 June 2025

X-comment from +make.wordpress.org/ai: Comment on AI Chat Agenda – 12 June 2025

X-post: Introducing the AI Team – Hallway Hangout Recap

X-comment from +make.wordpress.org/ai: Comment on Introducing the AI Team – Hallway Hangout Recap

X-post: Criteria for Creating or Migrating Repositories under the WordPress GitHub Organization

X-comment from +make.wordpress.org/project: Comment on Criteria for Creating or Migrating Repositories under the WordPress GitHub Organization