Convert by ngram

Markdown to Video for technical knowledge beyond the repository

Bring the Markdown source your technical team already maintains. Preserve the code, steps, and terminology while turning it into a narrated tutorial or product update for a broader audience.

Input · Markdown to VideoReady
chars 0 / 4000

Video generation uses credits. Review your estimate in ngram. MP4 downloads require Basic or higher.

How credits work

Trusted by teams at

HubSpotDeelZapierITVVeevaDP WorldGenpactSafetyCulture

How it works

Four steps from a Markdown file to a video people finish.

No timeline, no scene-by-scene scripting, no syntax to clean up. Paste the .md, review the plan containing the script, hit render.

01

Drop the Markdown in

Paste your raw Markdown or point at a public README URL, and ngram parses # heading levels, bullet and numbered lists, code fences, and blockquotes. Direct .md file upload is coming soon; paste and public URL work today.

02

Syntax becomes story

Each ## heading becomes a scene. Numbered steps build as sequence cards. Bullet lists animate in. Code fences render as readable on-screen blocks. The agent writes the voiceover from the prose, not the markup.

03

Review the plan containing the script

Approve, reorder, or rewrite scenes in plain language. Swap a visual, tighten a line, drop a section that reads better as text. Every change is one chat turn.

04

Ship and share

Export MP4 in 16:9, 1:1, or 9:16. Publish to a hosted /watch page, push to LinkedIn, or drop the link in the repo's release notes.

Output controls

Sensible defaults. Real controls when the file deserves them.

Heading-aware scene breaks

H1, H2, and H3 in the Markdown become real scene boundaries, not arbitrary 7-second chunks. A long section under one heading splits on its natural paragraph beats.

Code fences stay legible

Fenced code blocks and inline snippets render as monospace on-screen cards that hold long enough to read. The voiceover narrates the explanation around the snippet, not the syntax itself.

Verbatim or rewritten script

Keep the file's exact wording for a precise install guide, or let the agent rewrite dense prose for spoken voiceover. Toggle per scene.

Voiceover that fits the doc's tone

Brisk for a changelog, measured for an API reference, warm for a getting-started guide. Pick a brand voice or use a cloned one from /app/settings/voice.

Burned-in captions

Auto-generated and styled per brand kit. Numbered steps and command names stay readable; blockquotes hold for emphasis when the video plays muted.

Motion graphics for lists and tables

Bullet hierarchies animate in. Numbered steps stack as counter cards. Markdown tables render as branded scene cards instead of a flat grid of text.

Localized edits prepared separately

Render the same README as a German quickstart, a Spanish changelog, or a Portuguese integration guide. Captions, on-screen text, and voiceover all swap together.

Channel versions from one file

Prepare a 9:16 launch-post edit, a 1:1 LinkedIn edit, or a 16:9 hosted-docs edit from the same Markdown. Review each cut separately before exporting one MP4.

Use cases

Where the Markdown file in the repo becomes a video people watch.

Changelog

Turn CHANGELOG.md into a release video

The release section nobody scrolls becomes a 60-second branded video per ship. Each ### version heading is a scene; re-render straight from the updated Markdown next sprint.

See use case
Product updates

Release notes as a video your users finish

Paste the release-note Markdown and ship a video update instead of another bullet list. Higher feature adoption than a changelog entry that gets skimmed and closed.

See use case
API documentation

API reference .md as a walkthrough video

Endpoint headings, request and response blocks, and parameter tables in your API Markdown become a narrated walkthrough developers can watch before they read the full spec.

See use case
Integration guides

From install steps to a 200 OK, on screen

The numbered setup steps in an integration .md become a sequence of scene cards that walk a developer from npm install to the first successful call.

See use case
Help center

Help articles written in Markdown, watched in 90 seconds

Markdown-authored support articles get a short looping video version embedded at the top. Customers see the action instead of re-reading the steps, and tickets drop.

See use case
Developer docs

README that ships with a watchable intro

The getting-started README becomes a branded video developers can play before cloning. GitHub renders it inline, so the first impression of the repo is motion, not a wall of text.

See use case
Internal training

Runbooks and SOPs from Markdown to training modules

An ops runbook or onboarding SOP kept in Markdown becomes a modular training video. Steps stay numbered on screen; H2 sections become chapter breaks.

See use case
Internal communication

The strategy doc in the wiki, as a video

A planning doc written in Markdown opens nobody's inbox. The 3-minute branded video from the same file gets watched in the all-hands and reshared in Slack.

See use case

Tools that pair with this converter

Sharpen the source. Polish the output.

All ngram tools

Integrations

Fire Markdown to video from the repo, the editor, or the agent.

These recipes start from where your .md already lives: a merged README, a tagged CHANGELOG, a rendered docs page. Wire one up, or hit the REST API and self-managed webhook subscriptions for video.completed or video.failed to build your own.

REST APIMCP serverWebhook subscriptionsFor API automation, send supported text or URL inputs with a self-service API key, retrieve the video job status, and subscribe to video.completed or video.failed.

How it compares

If you've been doing this another way.

Slide-based Markdown tools render your .md as static deck frames. Avatar tools narrate the text over a presenter card. ngram reads the file's heading-and-list structure and builds a branded motion-graphic video with voiceover and captions.

FeaturengramMarp + screen recorderSynthesiaManual edit (Premiere or DIY)
Reads Markdown structure (headings, lists, code fences)Yes, headings become scenes, lists become sequences, code fences render legiblyRenders .md as static slides, no scene logicExtracts text; avatar narrates linearlyManual, depends on the editor
Time from .md to first cutMinutesSlides fast, then a manual screen-record passTens of minutes (script + render)Hours to days
Re-render when the file changesPaste the new .md, re-renderRe-export slides, re-recordRe-generate narrationRe-edit from scratch
Brand kit across every renderSet up and select your Brand KitTheme CSS per deckTemplate-level brandingManual per project
Voiceover from the proseAI voiceover written from the file, captions burned inNone, you record itAvatar voiceoverManual VO or none
Storyboard preview before renderFull scene plan, editable in chatSlide preview onlyGenerate first, edit afterEditor decides
Localized variantsVoiceover, captions, on-screen text translate togetherManual per languageAvatar voiceover per languageManual per language
Channel versions16:9, 1:1, 9:16 from one fileSlide aspect onlyOne format per exportManual reframe per format
Best whenYou want a branded, scene-based video directly from a Markdown fileYou want presentation slides from MarkdownYou want a talking-head presenter for the textYou have an editor and time to burn

Common questions about Markdown to video

How do I convert Markdown to video?

Paste your raw Markdown into ngram, or point at a public README URL. The agent reads the # headings, bullet and numbered lists, and code fences, then builds a scene-by-scene storyboard. Review the plan in chat, approve, and the system renders a branded MP4 with voiceover and captions.

What Markdown elements does the converter understand?

Heading levels (# through ###), unordered and ordered lists, fenced code blocks and inline code, blockquotes, and tables. Headings become scene breaks, numbered lists become sequence cards, tables render as branded scene cards, and code fences appear as readable monospace blocks.

Can I convert a GitHub README to video?

Yes. Paste the raw Markdown directly, or share the public README URL and ngram fetches the rendered page. It parses the same heading structure, lists, and code blocks whether you paste the file or link to it.

What file formats does the markdown to video converter accept?

Markdown source as .md, .markdown, .mdx, and plain .txt, plus pasted Markdown text. File upload is rolling out; paste and public URL work today. Image-only or binary files are not supported here.

How long can the source Markdown be?

Up to about 15,000 words per render. Past that, split the file by top-level heading and render chapter videos. ngram can chain them into a single hosted playlist on a /watch page.

What does the final video look like?

A branded motion-graphic video with an on-screen scene card per heading, animated bullet and numbered lists, legible code blocks, AI voiceover, and burned-in captions. Brand kit colors, fonts, and logo apply to every scene.

How do I keep the video in sync when the Markdown changes?

Re-paste the updated .md and re-render. The storyboard rebuilds from the new structure in a few minutes, so a changelog or README video stays current without a re-recording cycle.

How is this different from Marp or a slide tool for Markdown?

Marp and similar tools render your Markdown as static presentation slides that you then screen-record yourself. ngram reads the file's structure and builds a motion-graphic video with AI voiceover and captions directly, no manual recording pass and no slide deck in between.

Can I translate the Markdown video into other languages?

Yes. The same source .md can render localized versions where voiceover, captions, and on-screen text all switch language together. Useful for global docs, multi-region changelogs, and developer quickstarts.

Does ngram offer enterprise controls for docs and developer teams?

Yes. Workspace brand kits, team roles and invites, and hosted /watch pages with link controls are available on paid and enterprise plans. Talk to sales about security, access controls, and data handling for your team.

Markdown → Video

Ship the video version of the Markdown file your team already wrote.

Paste the README, changelog, or docs .md, review the plan containing the script, and render a branded video people watch instead of bookmark.

Put it into practice

Follow a workflow from source material to a video you can review, share and make again.

Each product release

Turn release notes into a customer update video in Claude

Give Claude the shipped changes. Use ngram to create a narrated update, review its plan and bring the finished video back to the conversation.

Release notes and real product screenshotsA narrated customer update

Ways to run: Claude

Every release

Turn release notes into a product update video

Give customers a short explanation of what shipped, who it helps and where to find it. Use your release notes to make a repeatable video update, then check the result against the shipped product.

Published release notesRelease roundup video

Ways to run: In ngram