Video to Markdown
Video to Markdown

How to embed a video in markdown? Here the answer. Add videos to your markdown files easier.

GitHub Website

Video to Markdown

Test Cloudinary     PayPal.me Sponsor

Chrome Web Store Firefox add-on

Add videos to your markdown files easier starting from here!

Why?

How often did you find yourself googling ¨How to embed a video in markdown?¨

While its not possible to embed a video in markdown, the best and easiest way is to extract a frame from the video, add a layer with a play icon and link the video url on the image.

Speaking HTMLese, this is what you would do:

<a href="{video-url}" title="Link Title"><img src="https://github.com/marcomontalbano/video-to-markdown/raw/main/{image-url}" alt="Alternate Text" /></a>

that translates into markdown as:

[![Alternate Text](https://github.com/marcomontalbano/video-to-markdown/raw/main/{image-url})]({video-url} "Link Title")

To speed up the process I developped this tool that will do it for you.

You just need to paste the video url in the field above and you will get the markdown you need.

Features

List of supported video providers:

A browser extension

Originally, this tool started as a simple website where you could paste a video URL and instantly get a nicely formatted Markdown snippet with the video thumbnail and title.

But over time, we ran into limitations: many websites restrict access to their content from external services, which made it harder to reliably fetch video metadata just from a pasted URL.

That’s why we moved to a browser extension.

By running directly in your browser, the extension can access video information from the page you’re currently viewing, with your permission. This makes the tool:

Just click the extension’s “Generate” button when you’re on a video page, and it will instantly generate the Markdown code for you - thumbnail included.

This change helps the service stay reliable, and super easy to use.

Development stuff

To run the project locally, here’s what you’ll need:

Requirements

Setup

cd into your local copy of the repository and run pnpm install

cd video-to-markdown
pnpm install
cp ./packages/service/.env.sample ./packages/service/.env
# update the .env with proper values
# update types
pnpm --filter service cf-typegen

# run the service
pnpm --filter service dev
# build the extension
BASE_URL=http://localhost:8787 pnpm --filter browser-extension build

# built extensions are available at:
# `./packages/browser-extension/dist-chrome.zip`
# `./packages/browser-extension/dist-firefox.zip`
# run the website
pnpm --filter website dev

# http://localhost:8080

Terms and Privacy Policy

Website: video-to-markdown.marcomontalbano.com

We anonymously track the number of visitors with Simple Analytics. No personal data is collected or stored.

Simple Analytics is a privacy-friendly analytics tool that does not use cookies or collect personal data. It provides insights into website traffic without compromising user privacy.

This site does not use cookies.

We do not store any other data on our servers.

Browser Extension: Video to Markdown (Chrome/Firefox)

When you use the extension’s “Generate” button, the current video thumbnail and URL are sent to our backend for processing. Cloudinary may be involved in image generation depending on the specific operation required.

Cloudinary is a cloud-based image and video management service that provides a comprehensive solution for managing and delivering images and videos. It offers features such as image and video upload, storage, transformation, optimization, and delivery through a global content delivery network (CDN).

The backend processes the data but does not store any of it.

No analytics, tracking scripts, or cookies are used by the extension itself.

No personal or usage data is collected, stored, or shared.

Terms of Use

By using this service, you agree to the following terms:

If you do not agree to these terms, please do not use this service.