GitHub READMEs
GitHub strips video players from Markdown. A clickable thumbnail with a play button is the next best thing.
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:
320 × 180px
[](https://youtu.be/VIDEO_ID)Paste into a README, issue, pull request, discussion or wiki on GitHub.
## Use cases
Built for GitHub first, useful everywhere else.
GitHub strips video players from Markdown. A clickable thumbnail with a play button is the next best thing.
Show a bug reproduction or a Loom demo right in the conversation. It works anywhere GitHub renders Markdown.
A single lightweight image instead of a heavy iframe player. Great for page speed, and it even works in emails.
GitLab, Notion, Obsidian, docs generators: anything that renders Markdown or HTML images.
## How it works
From YouTube, Vimeo, Loom, Rumble and more. We find the video for you.
Pick a size, a still image or an animated GIF, and add a title for screen readers.
Grab the Markdown or HTML snippet and drop it wherever you need it.
## API
Every thumbnail is just an image URL, so you can build them by hand or from a script. No keys, no sign-ups.
[](https://youtu.be/dQw4w9WgXcQ)/youtube/{video_id}/youtube/{video_id}.gif/vimeo/{video_id}/{service}/{video_id}/url?url={video_url}width int Width in pixels, up to 1920 default 320height int Height in pixels, up to 1080 default 180filetype str jpeg, png or webp Still images default jpegduration int Milliseconds per frame GIF only default 500