Docs 43 installs

Convert Plaintext Documentation to Markdown

by github/awesome-copilot

Convert a text-based document to markdown following instructions from prompt, or if a documented option is passed, follow the instructions for that option.

Skill content

Convert plain text documentation to markdown with flexible formatting options.

- Supports three conversion approaches: explicit instructions, documented options, or reference file templates for consistent formatting patterns

- Includes predefined instruction shortcuts for common tasks like removing header digits, adjusting heading levels, and reducing indentation

- Handles code block detection with language identification, proper list nesting, and markdown syntax compliance across multiple target platforms (GitHub, GitLab, VS Code, CommonMark, StackOverflow)

- Optional finalization mode trims formatting inconsistencies, escapes special characters, and standardizes spacing throughout the document

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