markdown-to-standalone-html

Convert Markdown documents into standalone HTML files with embedded images.

4|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/jonmagic/skills --skill markdown-to-standalone-html
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-to-standalone-html
Source: https://github.com/jonmagic/skills/tree/main/skills/markdown-to-standalone-html
Command: npx skills add https://github.com/jonmagic/skills --skill markdown-to-standalone-html

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandoc, ruby, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill converts Markdown documents into a portable, self-contained HTML file with embedded images, eliminating the need for external assets when sharing or archiving content.

Core Features & Use Cases

  • Offline-ready: Produces a single HTML file with all images embedded as base64 data URIs.
  • Image portability: Supports local image paths and public URLs in Markdown.
  • Use Case: Publish blog posts or reports that must be viewable offline or shared without dependencies.

Quick Start

Command example: ruby scripts/markdown_to_standalone_html.rb /path/to/post.md --title "Post Title" --template assets/template.html --out /path/to/output.html

Frequently Asked Questions about markdown-to-standalone-html

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

FAQPage Schema
How do I convert Markdown to a standalone HTML file with embedded images?

You can convert Markdown to a standalone HTML file by using a script that embeds local and public URL images as base64 data URIs, ensuring the document works offline without external assets. This process requires pandoc and Ruby installed on your PATH.

What is the best way to make an offline HTML report from Markdown?

The best way to make an offline HTML report from Markdown is generating a single self-contained HTML file. This approach embeds all images as base64 data URIs, eliminating external dependencies so the report is fully portable and viewable offline.

Does converting Markdown to self-contained HTML work with public URL images?

Yes, converting Markdown to self-contained HTML works with public URL images and local image paths. The tool fetches these images and embeds them directly into the HTML output as base64 data URIs for offline viewing.

Do I need pandoc and Ruby to convert Markdown into a single HTML file?

Yes, you need pandoc and Ruby installed on your system PATH to convert Markdown into a single HTML file. The conversion relies on a Ruby script and an HTML template processed through pandoc to produce the final embedded output.

Can I use a custom HTML template when converting Markdown to standalone HTML?

Yes, you can use a custom HTML template when converting Markdown to standalone HTML. The conversion script accepts a template file path as an argument, allowing you to apply custom styling and structure to the final self-contained HTML output.

Why convert blog posts into a single self-contained HTML file?

You convert blog posts into a single self-contained HTML file to ensure they remain viewable offline and can be shared without external asset dependencies. This embeds all images as base64 data URIs, making the content fully portable for archiving or distribution.