# Markdown to HTML Converter (`junipr/markdown-to-html`) Actor Convert Markdown to styled HTML with GFM support, syntax highlighting, tables, task lists. Choose GitHub, Dark, or Minimal theme. Code blocks with language highlighting. Full document or fragment output. - **URL**: https://apify.com/junipr/markdown-to-html.md - **Developed by:** [junipr](https://apify.com/junipr) (community) - **Categories:** Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.30 / 1,000 document converteds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Markdown to HTML Converter ### What does Markdown to HTML Converter do? Markdown to HTML Converter transforms Markdown text into styled, ready-to-use HTML. Provide Markdown content directly or point to a URL containing a Markdown file, and the actor produces a complete HTML document with your choice of theme, syntax highlighting for code blocks, and support for GitHub Flavored Markdown features like tables, task lists, and strikethrough text. The output can be a full HTML document with `` wrapper or a bare HTML fragment for embedding into existing pages. Two built-in themes are available (GitHub and Minimal), plus the option to inject custom CSS. The converted HTML is saved to the key-value store for direct download and also pushed to the dataset with conversion metadata. ### Features - **Two input methods** — paste Markdown directly or fetch from a URL - **Safety caps** — default max input size is 100,000 characters, configurable up to 250,000 - **GitHub Flavored Markdown** — tables, task lists, strikethrough, autolinks, and line breaks - **Syntax highlighting** — automatic code block highlighting powered by highlight.js with language detection - **Built-in themes** — GitHub theme (clean, modern, familiar) or Minimal theme (serif, reading-focused) - **Custom CSS** — inject additional CSS for branding or custom styling - **Fragment or document** — output a complete HTML page or just the HTML body fragment - **Zero-config** — runs with a sample Markdown document if no input is provided - **Direct download** — HTML output saved to key-value store as a downloadable file - **Pay-per-conversion pricing** — charged per document converted ### Input Configuration ```json { "markdown": "# Hello World\n\nThis is **bold** and *italic* text.\n\n```javascript\nconsole.log('Hello!');\n```", "markdownUrl": "", "maxMarkdownCharacters": 100000, "theme": "github", "includeStyles": true, "syntaxHighlight": true, "wrapInHtmlDocument": true, "gfm": true, "customCss": "" } ```` | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `markdown` | string | `""` | Raw Markdown text to convert. Takes priority over `markdownUrl`. | | `markdownUrl` | string | `""` | URL to a Markdown file to fetch and convert | | `maxMarkdownCharacters` | integer | `100000` | Maximum markdown characters per run, capped at 250,000 | | `theme` | string | `"github"` | CSS theme: `github`, `minimal`, or `none` | | `includeStyles` | boolean | `true` | Include CSS styles in the output | | `syntaxHighlight` | boolean | `true` | Enable code block syntax highlighting | | `wrapInHtmlDocument` | boolean | `true` | Wrap output in a complete HTML document. Set to false for HTML fragment. | | `gfm` | boolean | `true` | Enable GitHub Flavored Markdown (tables, task lists, strikethrough) | | `customCss` | string | `""` | Additional CSS to append to the output | ### Output Format The dataset contains conversion metadata and the full HTML output: ```json { "inputLength": 245, "outputLength": 1847, "theme": "github", "syntaxHighlight": true, "gfm": true, "wrapInHtmlDocument": true, "html": "\n\n...\n\n
\n

Hello World

\n

This is bold and italic text.

\n
\n\n", "scrapedAt": "2026-03-11T12:00:00.000Z" } ``` The complete HTML file is also saved to the key-value store under the key `OUTPUT` with content type `text/html`, making it directly downloadable and viewable in a browser. ### Usage Examples / Use Cases - **Documentation publishing** — convert Markdown docs, READMEs, and changelogs to styled HTML pages - **Blog content** — transform Markdown blog posts into HTML with syntax-highlighted code blocks - **Email templates** — generate HTML fragments from Markdown for use in email campaigns - **Static site generation** — batch-convert Markdown files to HTML as part of a build pipeline - **Report formatting** — produce presentable HTML reports from Markdown source files - **Apify pipeline step** — chain with other actors to convert scraped Markdown content to HTML ### Pricing This actor uses Pay-Per-Event (PPE) pricing: **$1.30 per 1,000 documents converted** ($0.0013 per event). Pricing includes all platform compute costs — no hidden fees. ### FAQ #### What is the difference between the GitHub and Minimal themes? The GitHub theme replicates the look of GitHub's Markdown rendering with a sans-serif font, 980px max width, bordered headings, and striped tables. The Minimal theme uses a serif font (Georgia), narrower 700px width, and a cleaner reading-focused layout. Choose `none` for unstyled HTML and provide your own CSS via the `customCss` field. #### Does this sanitize raw HTML inside Markdown? No. This actor converts Markdown to HTML and preserves raw inline HTML supported by the Markdown parser. If you render output from untrusted users in a browser, sanitize the HTML in your application before embedding it. #### Can I get just the HTML body without the full document wrapper? Yes. Set `wrapInHtmlDocument` to `false` and the actor will output only the HTML body content (with optional `