md

Convert Markdown documents into GitHub-styled HTML via the GitHub Markdown API.

Updated May 31, 2026
One-click install
npx skills add https://github.com/danseely/skills --skill md-danseely
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: md
Source: https://github.com/danseely/skills/tree/main/md
Command: npx skills add https://github.com/danseely/skills --skill md-danseely

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, python3, gh, and includes assets (resource) components.

What problem does it solve?

Render Markdown in a browser using GitHub's rendering pipeline to provide rich formatting for complex documents that are not well-suited to terminal output.

Core Features & Use Cases

  • Render Markdown via GitHub's /markdown API to produce HTML that preserves tables, task lists, code blocks, and syntax highlighting.
  • Wrap the rendered HTML in a template that loads github-markdown-css and github-syntax styles for a faithful GitHub-like presentation.
  • Open the result in a browser with a simple script (assets/render.sh) to streamline viewing and sharing.

Quick Start

Run assets/render.sh <path-to-markdown> to render and open the result in your browser.

Frequently Asked Questions about md

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

FAQPage Schema
How do I render markdown as HTML in a browser using GitHub styling?

To render markdown as HTML in a browser, this Skill converts documents via the GitHub Markdown API and applies github-markdown-css for syntax highlighting. It outputs a styled HTML file opened directly in your web browser.

Can I view markdown documents offline when GitHub API access is unavailable?

Yes, you can view markdown documents offline. When the GitHub API is unavailable, the Skill falls back to the client-side marked.js library to render markdown into HTML directly within the browser.

Does this markdown rendering approach preserve GitHub formatting like tables and task lists?

Yes, GitHub formatting is preserved during markdown rendering. By using the GitHub Markdown API mode gfm, the output HTML retains tables, task lists, code blocks, and syntax highlighting.

Do I need curl and python3 installed to render markdown in a browser?

Yes, you need curl and python3 installed. These dependencies execute the markdown rendering script, handle GitHub API requests, and open the resulting HTML output in your browser.

What is the best way to view long-form markdown reports outside the terminal?

The best way to view long-form markdown reports outside the terminal is converting them to browser-rendered HTML. This Skill wraps markdown in a GitHub-styled template for rich formatting and easy viewing.