Programmatically access Markdown documentation.


The Markdown Guide API provides a subset of documentation from the Markdown Guide in JSON format. We hope that software developers and organizations use this API to programmatically consume our documentation and display it in applications and on websites.


Why create an API for Markdown documentation? Because there’s so much duplicated Markdown documentation on the web! It seems like everybody has their own version of Markdown documentation for their application or website. That’s a shame since most of it is exactly the same.

Then came the epiphany. 💡 We realized we could create a JSON API using documentation from the Markdown Guide. That way, software developers could start using the API to include our documentation in their applications, and organizations like universities and libraries could use the API to include our documentation on their websites.

We’d love to see the Markdown Guide become the central documentation repository for the thousands of Markdown instructions sprinkled around the internet. Will it work? Who knows! One thing’s for sure though: We can’t wait to see what you do with it. 🤘


The Markdown Guide API is designed to provide only essential Markdown documentation. As a result, the API doesn’t include all of the documentation available on the Markdown Guide website. For example, the Adding Elements in Lists section is not available through the basic syntax endpoint.

Basic Syntax Endpoint

The basic syntax endpoint contains documentation about the Markdown elements outlined in John Gruber’s design document and described on the Basic Syntax page.


curl https://www.markdownguide.org/api/v1/basic-syntax.json


Cheat Sheet Endpoint

The cheat sheet endpoint provides an overview of the most popular basic and extended Markdown syntax elements, as described on the Cheat Sheet page.


curl https://www.markdownguide.org/api/v1/cheat-sheet.json



Here’s a list of all the changes we’ve made to the Markdown Guide API.

- Updated cheat sheet endpoint to include information about definition lists

- Updated links description to include information about adding titles

- Added cheat sheet endpoint

- Added section about escaping backticks in code

- Released API v1
- Published docs