markdown-beautifier
Formats rough text and data into polished, professional Markdown documents.
Install
mkdir -p .claude/skills/markdown-beautifier && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/18767" && unzip -o skill.zip -d .claude/skills/markdown-beautifier && rm skill.zipInstalls to .claude/skills/markdown-beautifier
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Transform raw notes, analysis, or data into clean, readable Markdown with tables, ASCII box diagrams, code fences, and visual hierarchy. Use when asked to beautify, format nicely, create a pretty report, or make output presentation-ready.Key capabilities
- →Identify the output goal (brief, technical, or narrative)
- →Normalize the input (trim noise, keep useful lines)
- →Add a clear structure: title, summary, details
- →Use tables for counts or comparisons
- →Use ASCII boxes for key callouts
How it works
The skill identifies the output goal and normalizes the input by trimming noise. It adds a clear structure with titles, summaries, and details, using tables for comparisons and ASCII boxes for key callouts.
Inputs & outputs
When to use markdown-beautifier
- →Formatting research notes
- →Creating technical reports
- →Cleaning up raw data output
About this skill
Markdown Beautifier
Overview
Turn rough text or data into publication-ready Markdown with clear hierarchy, tables, and boxed callouts. Prefer concise structure over long prose.
Quick Start
./scripts/generate_report.sh \
--input notes.txt \
--output report.md \
--style technical
Styles:
- technical: metrics + code fence
- summary: short bullets + full content
- podcast: outline + raw notes
Workflow
- Identify the output goal (brief, technical, or narrative).
- Normalize the input (trim noise, keep the useful lines).
- Add a clear structure: title, summary, details.
- Use tables for counts or comparisons.
- Use ASCII boxes only for key callouts.
Formatting Patterns
ASCII box:
+----------------------------------------------+
| NOTE: Keep the box short and skimmable. |
+----------------------------------------------+
Table:
| Category | Count | Status |
|:---------|------:|:------:|
| Alpha | 42 | ok |
| Beta | 17 | warn |
Callout:
> Note: This section summarizes the core risks.
Script
generate_report.sh
- Reads a text or markdown file and writes a structured markdown report.
- Supports --style technical|summary|podcast and optional --title.
./scripts/generate_report.sh \
--input data.txt \
--output report.md \
--style summary \
--title "Weekly Update"
When not to use it
- →When the input is already perfectly formatted Markdown
- →When the goal is to generate new content rather than format existing text
Limitations
- →Focuses on Markdown output format
- →Prefers concise structure over long prose
- →ASCII boxes are used only for key callouts
How it compares
This skill specifically transforms raw text into presentation-ready Markdown with structured elements like tables and ASCII diagrams, unlike general text formatting.
Compared to similar skills
markdown-beautifier side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| markdown-beautifier (this skill) | 0 | 1mo | Review | Beginner |
| marker | 22 | 6mo | Review | Beginner |
| markdown-converter | 5 | 2mo | Review | Beginner |
| enhance-claude-memory | 11 | 4mo | Review | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
marker
benchflow-ai
Convert PDF documents to Markdown using marker_single. Use when Claude needs to extract text content from PDFs while preserving LaTeX formulas, equations, and document structure. Ideal for academic papers and technical documents containing mathematical notation.
markdown-converter
steipete
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.
enhance-claude-memory
avifenesh
Use when improving CLAUDE.md or AGENTS.md project memory files.
doc-sync
solatis
Synchronizes docs across a repository. Use when user asks to sync docs.
wiki-sync
zoraxl
Use to sync the wiki from a merged PR or from a source doc/file path. Two modes — PR mode (post-merge: creates ADR if needed, flips ADR to accepted, updates wiki pages, appends log, records idempotency, archives related plan/source files) and doc mode (ingests existing implemented knowledge from a f
docs-governance
hakon1233
Before creating, renaming, or moving any `.md` file outside `src/`, or when the user says \"stray docs\", \"docs governance\", \"where should this doc live\", or runs the stray-doc auditor: invoke `Skill('docs-governance')` and place the file using its vault-synced allowlist and filename-heuristic t