--- seo_title: Markdown to HTML API for Rendering Markdown Files | EnConvert meta_desc: Render Markdown to HTML via POST /v1/convert/markdown-to-html. Get a complete styled HTML page with dark mode, tables, code blocks, and TOC support. keywords: markdown to html api, render markdown to html api, convert markdown to html, markdown to html converter api, markdown to html rest api, md to html api, markdown to html python requests, markdown rendering api --- # Markdown to HTML API The Markdown to HTML API converts a Markdown file to a fully styled HTML document with a single request to `POST /v1/convert/markdown-to-html`. Upload a `.md` or `.markdown` file via multipart form data and receive a complete, self-contained HTML page with embedded CSS, a responsive layout, and a built-in dark mode toggle. The result is ready to open in any browser. The HTML is returned directly by default, or set `direct_download=false` for JSON metadata with a presigned download URL. --- ## Endpoint ``` POST /v1/convert/markdown-to-html ``` **Content-Type:** `multipart/form-data` **Accepted input:** `.md` or `.markdown` files (UTF-8 encoded) **Output format:** `.html` (`text/html`) --- ## Authentication Requires either a private API key or a JWT token from a public key. ``` X-API-Key: sk_your_private_key ``` Or: ``` Authorization: Bearer ``` --- ## Request Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `file` | file | Yes | -- | The `.md` or `.markdown` file to convert. Must be UTF-8 encoded. | | `output_filename` | `string` | No | Input filename | Custom output filename. The `.html` extension is added automatically. | | `direct_download` | `boolean` | No | `true` | When `true`, returns the HTML document directly. When `false`, returns JSON metadata with a presigned download URL. | --- ## Conversion Rules The converter uses Python-Markdown with the following extensions enabled: | Extension | What It Does | |-----------|-------------| | `tables` | Pipe-delimited Markdown tables rendered as HTML `` elements | | `fenced_code` | Triple-backtick code blocks with language identifiers (` ```python `) | | `codehilite` | Syntax highlighting CSS classes on code blocks (via Pygments) | | `toc` | Table of contents generation via a `[TOC]` marker in your document | | `attr_list` | Attach HTML attributes to elements using `{.class #id}` syntax | ### Example **Input:** ~~~markdown # My Document [TOC] ## Introduction This is a **bold** and *italic* example. ## Data Table | Name | Age | City | |-------|-----|--------| | Alice | 30 | London | | Bob | 25 | Paris | ## Code Sample ```python def hello(): print("Hello, world!") ``` ~~~ **Output:** A complete `` document with: - The rendered Markdown inside a `` with max-width 800px, centered layout - Styled tables, code blocks, links, and headings - A clickable table of contents generated from the headings - A dark mode toggle button (top-right corner) that persists the user's preference to `localStorage` ### Output Styling The generated HTML includes an embedded `