convert-plaintext-to-md

This skill turns a GitHub Copilot agent into a technical documentation specialist that converts plain-text or generically formatted documentation files into properly structured Markdown. It solves the common problem of legacy or exported documentation arriving as raw text with inconsistent headings, indentation, and formatting, giving the agent a repeatable process for producing clean, platform-appropriate Markdown.

The skill supports three conversion approaches: following explicit instructions in the prompt, applying documented options, or using an already-converted Markdown file as a reference template so new files match an established style. It is driven by a command syntax that accepts a target file plus optional parameters and flags, including a `finalize` pass to trim whitespace and sloppy formatting, a `guide` reference file, target-platform selection (GitHub-flavored Markdown, StackOverflow, VS Code, GitLab, or CommonMark), header-level options, pattern-matching with stop points, and predefined transforms such as removing leading digits from headers, shifting heading levels, and reducing indentation. When a `.md` file does not already exist it copies the source file first, then applies Markdown best practices.

It is aimed at technical writers, open-source maintainers, and developers who need to migrate or normalize documentation at scale while keeping formatting consistent across a project. Typical uses include converting exported release notes, README drafts, or command references into publish-ready Markdown for a specific rendering platform.