convert-plaintext-to-md

Overview

This skill converts plain text or generic text-based documentation files into properly formatted markdown. It supports three conversion approaches: following explicit instructions, using documented conversion options, or using a previously converted markdown file as a reference template to ensure consistency across multiple document conversions.

Key Features

• Multiple Conversion Methods - Supports conversion from explicit instructions, documented option procedures, or reference file templates for flexible adaptation to different documentation needs
• Reference-Based Conversion - Uses a previously converted markdown file as a formatting guide, applying the same structure, conventions, and patterns to ensure consistency across document sets
• Incremental Updates - When a markdown version already exists, updates the existing file rather than overwriting it, preserving any manual edits and additions
• Platform-Aware Formatting - Accepts platform parameters to adapt markdown output for specific documentation platforms or rendering engines
• Parameterized Workflow - Supports multiple parameters including file input, reference guides, custom instructions, platform targets, pre-processing options, and finalization steps

Who is this for?

Technical writers and documentation teams who need to convert legacy plain text documentation into modern markdown format. Ideal for teams migrating documentation to markdown-based platforms (GitHub, GitLab, static site generators) who need consistent formatting across large documentation sets and want to use reference files for batch conversion.