Convert Plaintext to Markdown
Turns plain text documentation into formatted markdown, with optional headers, pattern matching and cleanup.
- Repository
- github/awesome-copilot
- Stars
- 40,703
- Licence
- MIT
- Files
- 1 file
What it does
When installed, the agent treats a plain text document as something to restructure into clean markdown. It can follow instructions you give it, a documented set of options, or a previously converted markdown file used as a template. It can add heading levels, apply patterns found in the file, trim messy spacing, and target a specific renderer such as GitHub, GitLab or VS Code. The skill describes the conversion process in prose; it does not ship any scripts of its own.
Great for
- Maintainers who have old README or plain text docs they want in markdown
- Technical writers converting a batch of text files to a consistent layout
- Anyone who wants a reference file's formatting copied onto a new document
Skip it if
- Documents that are already markdown and only need minor edits, since the skill is built for plain text input
- Very large or highly structured files where a dedicated converter tool would be more reliable and auditable; the agent's output may need manual review
Try asking
- “Convert notes.txt to markdown with headers added at level 2 for each section”
- “Convert this plain text manual to markdown using the same layout as guide.md”
- “Clean up the indentation in this text file and format it for GitHub, finalize”
- “Convert the document up to line 120 and stop there, following the rm-head-digits predefined instruction”
Install in 3 steps
- 1
Download the skill
The ZIP contains the 1 original files, the MIT licence and an attribution note.
convert-plaintext-to-md.zip - 2
Add it to your agent
Claude Code (all projects)
mkdir -p ~/.claude/skills && unzip convert-plaintext-to-md.zip -d ~/.claude/skills/Claude Code / Agent SDK (this project only)
mkdir -p .claude/skills && unzip convert-plaintext-to-md.zip -d .claude/skills/Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.
- 3
Ask for the task
No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.
Get better results
- Name the target platform (GitHub, GitLab, VS Code) so the output renders as you expect
- Provide a reference markdown file with guide to keep formatting consistent across several documents
- Review the result, since the skill copies the original file to a .md version and edits it in place
What's inside
- SKILL.md
Redistributed unmodified from github/awesome-copilot under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.