Free & open source · No sign-up Used by 100k+ people (apparently)

Put ![videos] in your Markdown

Turn a YouTube, Vimeo or Loom link (and more) into a clickable thumbnail with a play button, ready for GitHub READMEs, websites and docs.

Try an example:

README.md Preview
Your thumbnail will appear here
Style
Size
Format

320 × 180px

[![Video title](https://…/youtube/VIDEO_ID)](https://youtu.be/VIDEO_ID)

Paste into a README, issue, pull request, discussion or wiki on GitHub.

## Use cases

Works wherever Markdown or HTML does

Built for GitHub first, useful everywhere else.

GitHub READMEs

GitHub strips video players from Markdown. A clickable thumbnail with a play button is the next best thing.

Issues, PRs & discussions

Show a bug reproduction or a Loom demo right in the conversation. It works anywhere GitHub renders Markdown.

Websites & blogs

A single lightweight image instead of a heavy iframe player. Great for page speed, and it even works in emails.

Docs & wikis

GitLab, Notion, Obsidian, docs generators: anything that renders Markdown or HTML images.

## How it works

Three steps, about ten seconds

  1. Paste a link

    From YouTube, Vimeo, Loom, Rumble and more. We find the video for you.

  2. Tweak it

    Pick a size, a still image or an animated GIF, and add a title for screen readers.

  3. Copy & paste

    Grab the Markdown or HTML snippet and drop it wherever you need it.

## API

Prefer a URL? Use the API

Every thumbnail is just an image URL, so you can build them by hand or from a script. No keys, no sign-ups.

README.md
[![Definitely not a rickroll](https://markdown-videos-api.jorgenkh.no/youtube/dQw4w9WgXcQ)](https://youtu.be/dQw4w9WgXcQ)

Endpoints

  • GET /youtube/{video_id}
    Still thumbnail of a YouTube video YouTube
  • GET /youtube/{video_id}.gif
    Animated GIF made from frames of the video YouTubeGIF
  • GET /vimeo/{video_id}
    Still thumbnail of a Vimeo video Vimeo
  • GET /{service}/{video_id}
    Still thumbnail for imgur, loom, dailymotion or streamable More services
  • GET /url?url={video_url}
    Thumbnail from any supported link and Rumble Any link

Query parameters

  • width int Width in pixels, up to 1920 default 320
  • height int Height in pixels, up to 1080 default 180
  • filetype str jpeg, png or webp Still images default jpeg
  • duration int Milliseconds per frame GIF only default 500