---
title: Convert Markdown to JSON API
slug: markdown-to-json
url: https://apyverse.com/apyhub/service/markdown-to-json
provider: ApyHub
categories: [Data Extraction, Developer Tools, File Conversion]
auth: api_key
---

# Convert Markdown to JSON API

Convert Markdown from raw text, uploads, or URLs into structured JSON. Use it for docs ingestion, parsing, and content migration workflows.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/convert/md-url/json-raw` | What it does Converts the Markdown file at a given URL into a JSON representation and returns it in… | 50 |
| POST | `/convert/md-url/json-file` | What it does Converts a Markdown file available at a URL into a downloadable JSON file. The request… | 50 |
| POST | `/convert/md-url/json-url` | What it does Converts a Markdown file fetched from a URL into JSON and returns a signed S3 URL for… | 50 |
| POST | `/convert/md-file/json-file` | What it does Converts an uploaded Markdown file into a downloadable JSON file containing the parsed… | 50 |
| POST | `/convert/md-file/json-raw` | What it does Converts an uploaded Markdown file into JSON and returns the result inline. The reques… | 50 |
| POST | `/convert/md-file/json-url` | What it does Converts an uploaded Markdown file into JSON and returns a signed S3 URL to the genera… | 50 |
| POST | `/convert/md-raw/json-raw` | What it does Converts raw Markdown content into JSON and returns the result as a JSON array. Reques… | 50 |
| POST | `/convert/md-raw/json-file` | What it does Converts raw Markdown text into a JSON file and returns it as a downloadable binary re… | 50 |
| POST | `/convert/md-raw/json-url` | What it does Converts raw Markdown content into JSON and returns a signed S3 URL to the generated J… | 50 |

## About

## What it does
Markdown to JSON converts Markdown content into structured JSON. Send a Markdown file, a Markdown URL, or raw Markdown text, and get back the parsed document structure as inline JSON, a downloadable JSON file, or a signed S3 URL.

Use Markdown to JSON when you need to index documentation, inspect document structure, or move Markdown content into a downstream parser, search pipeline, or storage workflow. The service accepts remote Markdown URLs that return `text/markdown` or `text/plain`, uploaded Markdown files with `text/markdown` MIME type, and raw Markdown strings.

The responses vary by endpoint: inline conversions return a JSON array, file-download endpoints return a binary JSON file, and URL-based endpoints return a `data` field containing a signed S3 URL valid for 5 minutes. That gives you a simple way to choose between immediate processing and asynchronous file handling.

If you are building a docs ingestion flow, content migration job, or a Markdown analyzer, Markdown to JSON gives you the parsed output in a format you can store, validate, or transform further.

## Usage

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