Aquamarine
Contact Log in

Zendesk Article Markdown Converter

Paste the markdown from a Zendesk help center article and get clean, publish-ready HTML back. It's free and runs entirely in your browser, so nothing you paste leaves your machine.

Aquamarine renders these as an interactive list. Any other Zendesk theme publishes them as literal text, so switch this off unless you use Aquamarine.

Why Zendesk articles need converting

Zendesk publishes articles as HTML, but most people draft them in markdown, and the two disagree about line breaks. Zendesk shows a single line break as a visible break; standard markdown ignores it and folds those lines into one paragraph. A draft that looked well spaced in the editor comes out as a wall of text.

Fixing that by hand across a help center is slow and easy to get wrong. This converter applies the same corrections every time, so what you drafted is what readers see.

Line breaks become real paragraphs
Every single newline becomes a proper paragraph break, so the spacing you drafted is the spacing readers get.
FAQ sections become FAQ blocks
A section headed "FAQ" or "FAQs" with one bullet per question becomes the block format Aquamarine renders as an interactive list. Each bullet is the question, the lines beneath it the answer. Optional: switch it off above and the section stays an ordinary heading and bullet list.
Video links become inline players
A plain link to an .mp4 file becomes an embedded player that autoplays, loops, and stays muted. Tracking parameters on the URL are dropped.
Leftover formatting is cleaned up
Empty headings are removed, unterminated code fences are escaped so they cannot swallow the rest of the article, and runs of blank lines are collapsed. The finished HTML is then formatted so it stays readable if you need to edit it by hand.

Example

Two paragraphs that Zendesk would have run together, and an FAQ section written as plain bullets. Here is exactly what goes in and what comes out.

Markdown in

## Setting up webhooks

Open Admin Center and select Apps and integrations.
Choose Webhooks, then click Create webhook.

## FAQs

- Can I send to more than one endpoint?
  Yes. Create a separate webhook for each endpoint you need.
- What happens if my endpoint is down?
  Zendesk retries failed deliveries for up to 24 hours.

HTML out

<h2>Setting up webhooks</h2>

<p>Open Admin Center and select Apps and integrations.</p>
<p>Choose Webhooks, then click Create webhook.</p>

<h2>FAQs</h2>

<p>:::faq</p>
<p>Q: Can I send to more than one endpoint?</p>
<p>A: Yes. Create a separate webhook for each endpoint you need.</p>
<p>Q: What happens if my endpoint is down?</p>
<p>A: Zendesk retries failed deliveries for up to 24 hours.</p>
<p>:::</p>

Questions