---
title: Convert Markdown to JSON API
slug: convert-markdown-to-json
url: https://apyhub.com/apyhub/service/convert-markdown-to-json
provider: ApyHub
categories: [Ingestion Kit, Output Kit]
tags: [markdown, json-conversion, document-parsing, content-processing, file-conversion]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 9
atoms: 50
mcp: true
alias: converter-markdown-json
---

# Convert Markdown to JSON API

Convert raw Markdown, files, or URLs into structured JSON. Returns inline output, a downloadable JSON file, or a signed S3 URL for pipelines.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-file-json-raw` | What it does Uploads a Markdown file and converts it to JSON, returning the result inline as an arr… | 50 |
| POST | `https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-raw-json-url` | What it does Converts raw Markdown content into JSON and returns a signed S3 URL where the generate… | 50 |
| POST | `https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-url-json-file` | What it does Converts a Markdown document fetched from a URL into a JSON file and returns it as a d… | 50 |
| POST | `https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-url-json-url` | What it does Converts a Markdown file fetched from a remote URL into JSON and returns a signed S3 U… | 50 |
| POST | `https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-file-json-url` | What it does Converts an uploaded Markdown file into JSON and returns a signed S3 URL where the gen… | 50 |
| POST | `https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-raw-json-file` | What it does Converts raw Markdown content into a JSON file download. You send the Markdown text in… | 50 |
| POST | `https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-raw-json-raw` | What it does Converts raw Markdown text into JSON. The request body is a Markdown string, and the r… | 50 |
| POST | `https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-url-json-raw` | What it does Converts a Markdown file accessible at a URL into a JSON response. The request sends t… | 50 |
| POST | `https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-file-json-file` | What it does Converts an uploaded Markdown file into a downloadable JSON file containing the parsed… | 50 |

## Endpoint reference

### File upload  → JSON 

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

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `file` | body | string (binary) | yes | Markdown file to convert. Must have MIME type text/markdown. |

#### Quickstart

Upload a Markdown file to convert it into raw JSON.

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

#### What you'll get back

Returns a JSON array. The array items are not further specified by the schema.

### Raw Markdown → JSON 

`POST https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-raw-json-url` · 50 atoms · accepts `text/plain` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `body` | body | string | yes | Raw Markdown content. Example: `# Title

- item 1
- item 2`. |
| `output` | query | string | no | Default: `sample-output`. Example: `my-document`. |

#### Quickstart

Send raw Markdown in the request body to generate a JSON file URL.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-raw-json-url?output=my-document" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: text/plain" \
  --data-binary '# Title

- item 1
- item 2'
```

#### What you'll get back

Returns a JSON object with a required `data` string field containing a signed S3 URL for the generated JSON file.

```json
{
  "data": "https://s3.amazonaws.com/bucket/consumer/converter-markdown-json/file.json?..."
}
```

### URL → JSON 

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

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `url` | body | string (uri) | yes | URL pointing to a Markdown file. The remote resource must respond with a Content-Type of text/markdown or text/plain. Example: `https://assets.apyhub.com/samples/sample.md`. |
| `output` | query | string | no | Default: `sample-output`. Example: `my-document`. |

#### Quickstart

Convert a Markdown file from a URL into a downloadable JSON file.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-url-json-file?output=my-document" \
  -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 response: a downloadable JSON file containing the parsed document structure.

### URL → JSON 

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

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `url` | body | string (uri) | yes | URL pointing to a Markdown file. The remote resource must respond with a Content-Type of text/markdown or text/plain. Example: `https://assets.apyhub.com/samples/sample.md`. |
| `output` | query | string | no | Default: `sample-output`. Example: `my-document`. |

#### Quickstart

Convert a Markdown file from a public URL into JSON and return a signed download link.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-url-json-url?output=my-document" \
  -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 a signed S3 URL for the generated JSON file, valid for 5 minutes.

```json
{
  "data": "https://s3.amazonaws.com/bucket/consumer/converter-markdown-json/file.json?..."
}
```

### File upload → JSON 

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

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `file` | body | string (binary) | yes | Markdown file to convert. Must have MIME type text/markdown. |
| `output` | query | string | no | Default: `sample-output`. Example: `my-document`. |

#### Quickstart

Upload a Markdown file to convert it into a JSON file and return a signed download URL.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-file-json-url" \
  -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 — a signed S3 URL for the generated JSON file, valid for 5 minutes.

```json
{
  "data": "https://s3.amazonaws.com/bucket/consumer/converter-markdown-json/file.json?..."
}
```

### Raw Markdown → JSON 

`POST https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-raw-json-file` · 50 atoms · accepts `text/plain` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `body` | body | string | yes | Raw Markdown content. Example: `# Title

- item 1
- item 2`. |
| `output` | query | string | no | Default: `sample-output`. Example: `my-document`. |

#### Quickstart

Send raw Markdown in the request body to get back a downloadable JSON file.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-raw-json-file?output=my-document" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: text/plain" \
  --data-binary $'# Title\n\n- item 1\n- item 2'
```

#### What you'll get back

Returns a binary file response containing the parsed document structure as JSON. The output schema is a downloadable JSON file, so the response body is not a JSON object.

### Raw Markdown → JSON 

`POST https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-raw-json-raw` · 50 atoms · accepts `text/plain` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `body` | body | string | yes | Raw Markdown content. Example: `# Title

- item 1
- item 2`. |

#### Quickstart

Send raw Markdown in the request body to convert it into JSON.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-raw-json-raw" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: text/plain" \
  --data-binary $'# Title\n\n- item 1\n- item 2'
```

#### What you'll get back

Returns a JSON array. The schema does not declare the item shape, so the array items are unspecified.

### URL → JSON 

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

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `url` | body | string (uri) | yes | URL pointing to a Markdown file. The remote resource must respond with a Content-Type of text/markdown or text/plain. Example: `https://assets.apyhub.com/samples/sample.md`. |

#### Quickstart

Convert a Markdown file from a URL into raw JSON by sending the file URL in the request body.

```bash
curl -X POST "https://api.eu.apyhub.com/apyhub/convert-markdown-to-json/md-url-json-raw" \
  -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 array. The items are not further specified in the schema, so the array contents depend on the Markdown being converted.

### File upload → JSON 

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

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `file` | body | string (binary) | yes | Markdown file to convert. Must have MIME type text/markdown. |
| `output` | query | string | no | Default: `sample-output`. Example: `my-document`. |

#### Quickstart

Upload a Markdown file and get back a downloadable JSON file with the parsed document structure.

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

#### What you'll get back

Returns a binary JSON file (`string` with `format: binary`) containing the parsed document structure.

## About

## What it does
Markdown to JSON converts Markdown content into JSON output so you can parse documents without building your own renderer or tokenizer.

Send either raw Markdown text, a Markdown file upload, or a URL to a Markdown file. The service supports both inline JSON responses and downloadable JSON files, so you can choose the format that fits your workflow. For URL-based requests, the remote resource must respond with `text/markdown` or `text/plain`. For file uploads, the file must be `text/markdown`.

Use Markdown to JSON when you need to ingest docs, notes, README files, or content from CMS exports into a structured pipeline. It is a good fit for document processing jobs that store parsed output, sync content into internal tools, or hand off Markdown content to downstream validation and transformation steps.

Depending on the endpoint, the response is either a JSON array or an object containing a signed S3 `data` URL, or a downloadable JSON file. That gives you flexibility whether you want the parsed structure immediately in your app or as a file artifact for later processing.

## 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-json
