Markdown Report Generator

A productivity skill that takes one or more structured JSON data inputs and assembles them into a well-formatted Markdown report.

91Trust High

by hermeshub-coreproductivitybeginnerv2.0.1updated Mar 5, 2026

11.2kTotal Runs

94.9%Success Rate

4.2kInstalls

91Trust Score

Required Tools

json_parsefile_write

Inputs

Name	Type	Description	Req
title	text	Report title.	yes
sections	json	Array of section objects: { heading: string, content: string \| object \| array }. Arrays are rendered as tables.	yes
include_toc	boolean	Whether to include a table of contents. Defaults to true.	--
include_summary	boolean	Whether to auto-generate an executive summary at the top. Defaults to false.	--
output_path	file	File path to write the report to. If omitted, the Markdown is returned as a string.	--

Outputs

Name	Type	Description	Req
report	text	The generated Markdown report as a string.	yes

Compatible Skills

HackerNews Scraperresearch

AI Paper Summarizerresearch

CSV Analyzerdata

Git Changelogdevelopment

Slack Notifiercommunication

gogcliproductivity

Polymarketfinance

SKILL.md

---
name: markdown-converter
description: Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XML, images (with EXIF/OCR), audio (with transcription), ZIP archives, YouTube URLs, or EPubs to Markdown format for LLM processing or text analysis.
---

# Markdown Converter

Convert files to Markdown using uvx markitdown — no installation required.

## Basic Usage

```bash
# Convert to stdout
uvx markitdown input.pdf

# Save to file
uvx markitdown input.pdf -o output.md
uvx markitdown input.docx > output.md

# From stdin
cat input.pdf | uvx markitdown
```

## Supported Formats

- Documents: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls)
- Web/Data: HTML, CSV, JSON, XML
- Media: Images (EXIF + OCR), Audio (EXIF + transcription)
- Other: ZIP (iterates contents), YouTube URLs, EPub

## Options

```bash
-o OUTPUT      # Output file
-x EXTENSION   # Hint file extension (for stdin)
-m MIME_TYPE   # Hint MIME type
-c CHARSET     # Hint charset (e.g., UTF-8)
-d             # Use Azure Document Intelligence
-e ENDPOINT    # Document Intelligence endpoint
--use-plugins  # Enable 3rd-party plugins
--list-plugins # Show installed plugins
```

## Examples

```bash
# Convert Word document
uvx markitdown report.docx -o report.md

# Convert Excel spreadsheet
uvx markitdown data.xlsx > data.md

# Convert PowerPoint presentation
uvx markitdown slides.pptx -o slides.md

# Convert with file type hint (for stdin)
cat document | uvx markitdown -x .pdf > output.md

# Use Azure Document Intelligence for better PDF extraction
uvx markitdown scan.pdf -d -e "https://your-resource.cognitiveservices.azure.com/"
```

## Notes

- Output preserves document structure: headings, tables, lists, links
- First run caches dependencies; subsequent runs are faster
- For complex PDFs with poor extraction, use -d with Azure Document Intelligence