pandoc-markdown

Convert Markdown files to HTML with Pandoc and optional Table of Contents.

1|Updated Sep 5, 2025
One-click install
npx skills add https://github.com/Ramblurr/nix-devenv --skill pandoc-markdown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pandoc-markdown
Source: https://github.com/Ramblurr/nix-devenv/tree/main/prompts/skills/pandoc-markdown
Command: npx skills add https://github.com/Ramblurr/nix-devenv --skill pandoc-markdown

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the conversion of Markdown files into HTML, making them easily viewable and shareable across different platforms.

Core Features & Use Cases

  • Markdown to HTML Conversion: Transforms Markdown content into well-formatted HTML.
  • Table of Contents Generation: Automatically creates a navigable Table of Contents for long documents.
  • Header Backlinks: Adds convenient links from headings back to the TOC.
  • Remote HTML Serving: Optionally starts a local HTTP server to view the HTML output remotely.
  • Use Case: Convert a project's README.md file into an HTML document with a TOC and serve it locally for easy previewing before deployment.

Quick Start

Convert the markdown file located at '/path/to/your/document.md' to an HTML file.

Frequently Asked Questions about pandoc-markdown

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

FAQPage Schema
How do I convert a Markdown file to HTML with a table of contents?

You can convert Markdown to HTML and automatically generate a navigable table of contents using Pandoc, with a Lua filter adding backlinks from headings back to the TOC for easy navigation.

Can I serve generated HTML files locally for remote previewing?

Yes, after converting Markdown to HTML, you can start a background Python HTTP server on specified ports to serve the generated HTML files remotely for easy previewing.

Do I need Pandoc installed to convert Markdown to HTML?

Yes, Pandoc is required to convert Markdown to HTML. The process includes a Pandoc installation check and provides detailed failure handling if the dependency is missing.

What is the best way to add header backlinks when converting Markdown to HTML?

The best way to add header backlinks during Markdown to HTML conversion is using a Lua filter, which automatically inserts convenient links from document headings back to the table of contents.

Why does my Markdown to HTML conversion fail with a missing dependency error?

Markdown to HTML conversion fails when Pandoc is not installed on your system. The process validates files and checks for Pandoc installation, providing detailed failure handling for missing dependencies.