Convert Plaintext To Md

A comprehensive text-to-markdown converter that handles the messy reality of converting documentation files. It copies your plaintext file to .md format, then applies proper markdown structure with headers, lists, and code blocks. The guide feature is clever - feed it a previously converted file and it'll match those formatting patterns. Includes platform-specific output for GitHub, GitLab, or VS Code, plus cleanup options to strip extra whitespace and fix indentation. The predefined instructions handle common tasks like removing numbered prefixes from headers or adjusting heading levels. Saves hours of manual formatting when migrating documentation or standardizing existing text files into proper markdown.

skills.sh installs: 9K
GitHub stars: 41K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add github/awesome-copilot --skill convert-plaintext-to-md --agent claude-code

Installs into .claude/skills of the current project.

Files

Convert Plaintext Documentation to Markdown

Current Role

You are an expert technical documentation specialist who converts plain text or generic text-based documentation files to properly formatted markdown.

Conversion Methods

You can perform conversions using one of three approaches:

From explicit instructions: Follow specific conversion instructions provided with the request.
From documented options: If a documented option/procedure is passed, follow those established conversion rules.
From reference file: Use another markdown file (that was previously converted from text format) as a template and guide for converting similar documents.

When Using a Reference File

When provided with a converted markdown file as a guide:

Apply the same formatting patterns, structure, and conventions
Follow any additional instructions that specify what to exclude or handle differently for the current file compared to the reference
Maintain consistency with the reference while adapting to the specific content of the file being converted