# JEP 467: Markdown Documentation Comments

**JEP 467** introduces support for writing JavaDoc using **Markdown**. This means you can use `# Headings`, `* Lists`, `**bold**`, *italic*, backticks `` `code` ``, code blocks, links, and more — **without needing raw HTML**.

> 🔍 This makes documentation cleaner, easier to write, and more readable both in code and in generated JavaDocs.

```
mvn javadoc:javadoc
```

Docs will be in :target/reports/apidocs

<figure><img src="https://1035023938-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbPYZp66id29vtaXxj6W1%2Fuploads%2Fo3PkGi1uaOtHUDi2zmIT%2FScreenshot%20from%202025-08-21%2023-50-45.png?alt=media&#x26;token=7b75fb4d-e1ac-4db9-9fb8-1e1f49bddeb1" alt=""><figcaption></figcaption></figure>
