> ## Documentation Index
> Fetch the complete documentation index at: https://docs.htmldrop.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Publishing Markdown

> Drop a .md file and get a styled, readable page — no theme to pick.

Drop a `.md` or `.markdown` file and htmldrop renders it to a styled HTML page
server-side. You do not choose a theme or write any CSS.

This is the fastest route for anything that is fundamentally text: release notes,
a proposal, meeting notes, a runbook, an RFC.

## What is supported

Standard CommonMark, including:

* Headings, lists, and nested lists
* **Bold**, *italic*, `inline code`, and fenced code blocks
* Links, images, and blockquotes
* Tables
* Horizontal rules

The rendered page is responsive and readable on a phone without any work from
you.

## Via the API

Markdown has its own endpoint that takes JSON rather than a file upload:

```bash theme={null}
curl -X POST https://htmldrop.app/api/v1/drops-md \
  -H "Content-Type: application/json" \
  -d '{"title":"Q3 notes","markdown":"# Q3 notes\n\nWe shipped."}'
```

The `title` becomes the page title and the dashboard label. See
[anonymous drops](/api/anonymous-drops) for the full contract.

<Tip>
  If you want precise control over layout, publish [HTML](/publishing/html)
  instead. Markdown is for when you want to write and be done.
</Tip>