pandoc-video

Generate video embed snippets for Markdown converted with Pandoc to HTML or EPUB.

1|Updated May 26, 2026
One-click install
npx skills add https://github.com/nimdvir/dima-publishing --skill pandoc-video-nimdvir
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pandoc-video
Source: https://github.com/nimdvir/dima-publishing/tree/main/.agents/skills/pandoc-video
Command: npx skills add https://github.com/nimdvir/dima-publishing --skill pandoc-video-nimdvir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Pandoc Markdown has no native video syntax, so authors publishing to HTML and EPUB struggle to embed videos in a way that works across output formats. This Skill provides ready-to-paste embed patterns matched to the target format. ## Core Features & Use Cases - Direct MP4 Embed: Produces an HTML <video> element snippet for local or hosted MP4 files, with poster and playsinline options. - Iframe Embed: Generates YouTube or Vimeo iframe embed code for HTML-only output. - YouTube Thumbnail Link: Extracts the video ID from any YouTube URL format and builds a clickable thumbnail link using img.youtube.com, the safest cross-format option for HTML plus EPUB. - Use Case: You are writing a course book in Markdown that Pandoc converts to both a website and an EPUB. Paste a YouTube URL and receive a normalized watch URL plus a thumbnail link snippet that renders correctly in both outputs. ## Quick Start Embed this YouTube video https://www.youtube.com/watch?v=abc123 into my Markdown chapter so it works in both HTML and EPUB output.

Frequently Asked Questions about pandoc-video

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I embed a video in Markdown for Pandoc?▼

Pandoc Markdown has no native video syntax, so use raw HTML. For MP4 files, insert a <video> element with controls and a source tag. For YouTube or Vimeo, use an iframe embed for HTML output or a clickable thumbnail link for cross-format documents.

How to add a YouTube video to an EPUB made with Pandoc?▼

The safest EPUB-compatible pattern is a clickable image thumbnail linking to the YouTube watch URL. Derive the thumbnail from https://img.youtube.com/vi/VIDEO_ID/hqdefault.jpg and wrap it in a Markdown link, optionally with a caption.

Does iframe embed code work in EPUB readers?▼

No, iframe embeds are not recommended for EPUB because many readers do not render iframes reliably. Use iframes only for HTML output, and prefer a linked thumbnail image when targeting EPUB or multiple formats.

How do I get a YouTube thumbnail from a video URL?▼

Extract the video ID from watch, youtu.be, embed, or shorts URL formats, then build the thumbnail URL as https://img.youtube.com/vi/VIDEO_ID/hqdefault.jpg. Higher quality options like maxresdefault.jpg exist but hqdefault.jpg is the safe default without validation.

When should I use direct MP4 embed versus a YouTube link?▼

Use a direct MP4 <video> embed for HTML-only output when you host the file yourself. Choose a YouTube thumbnail link when the document targets both HTML and EPUB, since embedded video support in EPUB readers is uneven.