Writing docs in ReadMe is done in [Markdown eXtended](https://mdxjs.com) (MDX), which is based on the [CommonMark specification](https://commonmark.org). Unlike pure Markdown, MDX uses a slightly different syntax called [Javascript XML](https://react.dev/learn/writing-markup-with-jsx) (JSX). There are some slight differences when writing MDX compared to Markdown if you’re attempting to write HTML. ## Markdown vs MDX All pages in ReadMe use MDX to offer you the ability to write reusable and interactive components. Generally, it shouldn’t make a difference when writing Markdown—unless you’re writing HTML. It _looks_ like HTML, but is stricter. The most common issue is that you cannot have self-closing tags in JSX: Invalid ```

``` Valid ```

``` All JSX-style tags must be explicitly closed, including self-closing tags. Invalid ```
Content

1
2
3
``` Valid ```
Content

1

2

3

``` Most attributes will need to be camelCase—except `data-` and `aria-`. Inline styles will need to be an object `{}` and those properties also must be camelCase when written in JSX (does not apply if you’re writing CSS in a ` `} **Tip:** If you're running into other quirks or errors when working with MDX, check out [Troubleshoot MDX Errors](https://docs.readme.com/main/docs/rendering-errors-invalid-mdx) for more common issues. ## Writing JSX When editing your docs, you can write dynamic components in JSX, in a few ways: 1. **On the page:** Write your JSX in plain text. The editor will automatically parse your syntax and highlight your JSX. 2. **[Reusing Components](https://docs.readme.com/main/docs/building-custom-mdx-components/):** To write a component you can reuse in any page, open your **Settings** and navigate to the **Custom Components** page. Once you write your first component, you can reuse them on any page: `` 3. **[Out-of-the-box](https://docs.readme.com/main/docs/built-in-components/):** Our editor makes it easy to use components we’ve built into ReadMe. You can find them by opening the command menu by typing `/` in the editor. Under the **Component** section, you can choose the `Tabs`, `Accordion`, `Columns`, or `Cards` components. 4. **Public Components:** We also maintain a [component marketplace](https://github.com/readmeio/marketplace) where anyone can submit a component.