---
title: Convert Markdown to HTML files API
slug: convert-markdown-to-html-files
url: https://apyhub.com/apyhub/service/convert-markdown-to-html-files
provider: ApyHub
categories: [Output Kit]
tags: [markdown-to-html, markdown, html, file-conversion]
auth: api_key
version: 1.1.0
service_type: sync
endpoints: 4
atoms: 50
mcp: true
alias: converter-md-html
---

# Convert Markdown to HTML files API

Convert Markdown files or Markdown URLs into HTML downloads or signed links. Built for docs, changelogs, and static publishing workflows.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/apyhub/convert-markdown-to-html-files/file/download` | What it does Converts an uploaded Markdown file to HTML and returns the generated file as a binary… | 50 |
| POST | `https://api.eu.apyhub.com/apyhub/convert-markdown-to-html-files/file/link` | What it does Converts an uploaded Markdown file into an HTML file and returns a signed URL to the g… | 50 |
| POST | `https://api.eu.apyhub.com/apyhub/convert-markdown-to-html-files/url/download` | What it does Converts a remote Markdown file fetched from a URL into an HTML file for download. You… | 50 |
| POST | `https://api.eu.apyhub.com/apyhub/convert-markdown-to-html-files/url/link` | What it does Converts a remote Markdown file, identified by its URL, into a signed HTML file URL. T… | 50 |

## Endpoint reference

### Convert uploaded Markdown file to HTML download

`POST https://api.eu.apyhub.com/apyhub/convert-markdown-to-html-files/file/download` · 50 atoms · accepts `multipart/form-data` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `file` | body | string (binary) | yes | Markdown file (.md) to convert. Mandatory. |
| `output` | query | string | no | Example: `index.html`. |

#### Quickstart

Upload a Markdown file to convert it and optionally name the output HTML file.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/convert-markdown-to-html-files/file/download?output=index.html" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/file.md"
```

#### What you'll get back

Returns a binary file download (`string` with `format: binary`), not a JSON object.

### Convert uploaded Markdown file to signed HTML URL

`POST https://api.eu.apyhub.com/apyhub/convert-markdown-to-html-files/file/link` · 50 atoms · accepts `multipart/form-data` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `file` | body | string (binary) | yes | Markdown file (.md) to convert. Mandatory. |

#### Quickstart

Convert a local Markdown file to HTML by uploading it as multipart form data.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/convert-markdown-to-html-files/file/link" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/file.md"
```

#### What you'll get back

Returns a JSON object with a `data` string field containing a URI.

```json
{
  "data": "https://example.com/output.html"
}
```

### Convert remote Markdown URL to HTML download

`POST https://api.eu.apyhub.com/apyhub/convert-markdown-to-html-files/url/download` · 50 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `url` | body | string (uri) | yes | Example: `https://assets.apyhub.com/samples/sample.md`. |

#### Quickstart

Download the HTML generated from a Markdown file URL by sending the source `url`.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/convert-markdown-to-html-files/url/download" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://assets.apyhub.com/samples/sample.md"}'
```

#### What you'll get back

Returns a binary file response (`string` with `format: binary`), which is the downloaded HTML content.

```text
(binary file)
```

### Convert remote Markdown URL to signed HTML URL

`POST https://api.eu.apyhub.com/apyhub/convert-markdown-to-html-files/url/link` · 50 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `url` | body | string (uri) | yes | Example: `https://assets.apyhub.com/samples/sample.md`. |

#### Quickstart

Convert a Markdown file from a public URL into HTML by sending its link.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/convert-markdown-to-html-files/url/link" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://assets.apyhub.com/samples/sample.md"}'
```

#### What you'll get back

Returns a JSON object with a `data` string field containing the URI of the generated HTML file.

```json
{
  "data": "https://..."
}
```

## About

## What it does
Markdown to HTML converts a Markdown file or a remote Markdown URL into HTML output. Send a `.md` file in the request body, or pass a `url` to a hosted Markdown document, and get HTML back as either a downloadable file or a signed link.

Use the file endpoints when you want to upload Markdown directly, or the URL endpoints when the source already lives somewhere else. The download variants return HTML as binary output, while the link variants return a JSON object with a `data` field containing a URI.

This is useful when you generate documentation, changelogs, README pages, or knowledge-base articles in Markdown and need to publish them as HTML for a web app, CMS, or static site pipeline. You control the output filename on the download endpoint with the `output` query parameter.

Markdown to HTML is a straightforward conversion layer for teams that want to move between authoring-friendly Markdown and browser-ready HTML without building their own parser or file handling logic.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/apyhub/service/convert-markdown-to-html-files
