Mmcp.market

convert-plaintext-to-md skill

by github·github/awesome-copilot·39k stars·MIT

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

A100/100content scan

Is the convert-plaintext-to-md skill safe?

Clean: nothing in its files matched our rules. We read 1 file in the folder on 2026-09-28.

No findings.

Install the convert-plaintext-to-md skill

A skill is a folder. Copy it into your agent's skills folder and the agent loads it when the task matches its description. 

git clone --depth 1 https://github.com/github/awesome-copilot.git /tmp/awesome-copilot
mkdir -p ~/.claude/skills
cp -r /tmp/awesome-copilot/skills/convert-plaintext-to-md ~/.claude/skills/convert-plaintext-to-md
available in every project

In the Claude apps, zip the folder and upload it from the Skills settings. The folder on GitHub

The instructions your agent would load

SKILL.md as published, without the frontmatter. Read it on GitHub

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:

conversion rules.

  1. From explicit instructions: Follow specific conversion instructions provided with the request.
  2. From documented options: If a documented option/procedure is passed, follow those established

as a template and guide for converting similar documents.

  1. From reference file: Use another markdown file (that was previously converted from text format)

When Using a Reference File

When provided with a converted markdown file as a guide:

current file compared to the reference

  • Apply the same formatting patterns, structure, and conventions
  • Follow any additional instructions that specify what to exclude or handle differently for the

converted

  • Maintain consistency with the reference while adapting to the specific content of the file being

Usage

This prompt can be used with several parameters and options. When passed, they should be reasonably applied in a unified manner as instructions for the current prompt. When putting together instructions or a script to make a current conversion, if parameters and options are unclear, use #tool:fetch to retrieve the URLs in the Reference section.

/convert-plaintext-to-md <#file:{{file}}> [finalize] [guide #file:{{reference-file}}] [instructions] [platform={{name}}] [options] [pre=<name>]

Parameters

If a corresponding {{file}}.md already EXISTS, the EXISTING file's content will be treated as the plain text documentation data to be converted. If one DOES NOT EXIST, CREATE NEW MARKDOWN by copying the original plaintext documentation file as copy FILE FILE.md in the same directory as the plain text documentation file.

  • #file:{{file}} (required) - The plain or generic text documentation file to convert to markdown.

trim space characters, indentation, and/or any additional sloppy formatting after the conversion.

  • finalize - When passed (or similar language is used), scan through the entire document and

formatting patterns, structure, and conventions.

  • guide #file:{{reference-file}} - Use a previously converted markdown file as a template for

and alerts

  • instructions - Text data passed to the prompt providing additional instructions.
  • platform={{name}} - Specify the target platform for markdown rendering to ensure compatibility:
  • GitHub (default) - GitHub-flavored markdown (GFM) with tables, task lists, strikethrough,
  • StackOverflow - CommonMark with StackOverflow-specific extensions
  • VS Code - Optimized for VS Code's markdown preview renderer
  • GitLab - GitLab-flavored markdown with platform-specific features
  • CommonMark - Standard CommonMark specification

Options

  • --header [1-4] - Add markdown header tags to the document:
  • [1-4] - Specifies the header level to add (# through ####)
  • #selection - Data used to:
  • Identify sections where updates should be applied
  • Serve as a guide for applying headers to other sections or the entire document
  • Auto-apply (if none provided) - Add headers based on content structure
  • -p, --pattern - Follow an existing pattern from:
  • #selection - A selected pattern to follow when updating the file or a portion of it
  • IMPORTANT: DO NOT only edit the selection when passed to {{[-p, --pattern]}}
  • NOTE: The selection is NOT the WORKING RANGE
  • Identify pattern(s) from the selection
  • Stopping Points:

Predefined Instructions

If any of the predefined instructions are passed as an argument, expand and use them as ADDITIONAL input for the prompt instructions. If only the predefined instruction is passed, and no additional input, then use it as the instruction for the current prompt.

Syntax

/convert-plaintext-to-md pre=<name>

Predefined

plaintext to markdown.

  • rm-head-digits - Remove any prepending numbers from the headers when updating or converting the

updating or converting plaintext to markdown.

  • mv-head-level(x, y) - Change the heading level from level x header to a level y header when

x when updating or converting plaintext to markdown.

  • rm-indent(x) - Decrease the indentation of paragraphs or raw text data portions of the file by

[!NOTE]

If there is no matching predefine, then disregard the pre=name for the current prompt.

Usage Example

Basic Use

User

/convert-plaintext-to-md #file

Agent

I see there is no corresponding `file.md`. Let me copy the plaintext document:

cp file file.md

Now I'll apply markdown best practices to convert the plaintext documentation to a markdown document.

Using a Guide to Convert to Markdown

User

/convert-plaintext-to-md #file.md --guide #CODE.md

Agent

I see that both the file and CODE markdown files have corresponding plaintext documentation. Let me
check CODE and compare it to CODE.md, and identify patterns to help with conversion.

    CODE

Title

Text in opening.

1.1 Section Item

  1. Section

More skills from github/awesome-copilot

  • Aacquire-codebase-knowledgeUse this skill when the user explicitly asks to map, document, or onboard into an existing codebase. Trigger for prompts like "map this codebase", "document this architecture", "onboard me to this repo", or "create codebase docs". Do not trigger for routine feature implementation, bug fixes, or narrow code edits unless the user asks for repository-level discovery.
  • Aacreadiness-assessRun the AgentRC readiness assessment on the current repository and produce a static HTML dashboard at reports/index.html. Wraps `npx github:microsoft/agentrc readiness` and hands off rendering to the @ai-readiness-reporter custom agent. Supports policies (--policy) for org-specific scoring. Use when asked to assess, audit, or score the AI readiness of a repo.
  • Aacreadiness-generate-instructionsGenerate tailored AI agent instruction files via AgentRC instructions command. Produces .github/copilot-instructions.md (default, recommended for Copilot in VS Code) plus optional per-area .instructions.md files with applyTo globs for monorepos. Use after running /acreadiness-assess to close gaps in the AI Tooling pillar.
  • Aacreadiness-policyHelp the user pick, write, or apply an AgentRC policy. Policies customise readiness scoring by disabling irrelevant checks, overriding impact/level, setting pass-rate thresholds, or chaining org baselines with team overrides. Use when the user asks about strict mode, AI-only scoring, custom weights, CI gating, or wants org-wide standardisation.
  • Aad-campaign-analyzerUse this skill when the user shares ad campaign performance data and asks what to cut, scale, or test. Trigger for prompts like "analyze my ad campaigns", "where am I wasting ad spend", "reallocate my ad budget", "which ads are actually working", or "ROAS analysis". Do not trigger for campaign planning or creative generation without performance data.
  • Aadd-educational-commentsAdd educational comments to the file specified, or prompt asking for file to comment if one is not provided.
  • Aadobe-illustrator-scriptingWrite, debug, and optimize Adobe Illustrator automation scripts using ExtendScript (JavaScript/JSX). Use when creating or modifying scripts that manipulate documents, layers, paths, text frames, colors, symbols, artboards, or any Illustrator DOM objects. Covers the complete JavaScript object model, coordinate system, measurement units, export workflows, and scripting best practices.
  • Aagent-architectureDesign AI agent architectures through requirements discovery, or audit and diagnose architectural flaws in existing agents. Architecture only; excludes implementation and general code review.
  • Aagent-governancePatterns and techniques for adding governance, safety, and trust controls to AI agent systems. Use this skill when: - Building AI agents that call external tools (APIs, databases, file systems) - Implementing policy-based access controls for agent tool usage - Adding semantic intent classification to detect dangerous prompts - Creating trust scoring systems for multi-agent workflows - Building audit trails for agent actions and decisions - Enforcing rate limits, content filters, or tool restrictions on agents - Working with any agent framework (PydanticAI, CrewAI, OpenAI Agents, LangChain, AutoGen)
  • Aagent-owasp-complianceCheck any AI agent codebase against the OWASP Agentic Security Initiative (ASI) Top 10 risks. Use this skill when: - Evaluating an agent system's security posture before production deployment - Running a compliance check against OWASP ASI 2026 standards - Mapping existing security controls to the 10 agentic risks - Generating a compliance report for security review or audit - Comparing agent framework security features against the standard - Any request like "is my agent OWASP compliant?", "check ASI compliance", or "agentic security audit"
  • Aagent-skill-stackFind, evaluate, and assemble the smallest compatible set of AI Agent Skills for an end-to-end natural-language goal. Use when a user wants Skills for a multi-step workflow, asks which Skills fit a project, needs an installed-Skill audit or conflict check, has low Skill recall, wants indirect helpers such as humanizers or compliance checks, or wants a project-specific Skill Stack with controlled installation. Search local Skills, registries, GitHub, and OpenCLI; compare adoption, verified fit, safety, and overlap. Do not use for locating one known or common Skill; use the generic find-skills workflow.
  • Aagent-supply-chainVerify supply chain integrity for AI agent plugins, tools, and dependencies. Use this skill when: - Generating SHA-256 integrity manifests for agent plugins or tool packages - Verifying that installed plugins match their published manifests - Detecting tampered, modified, or untracked files in agent tool directories - Auditing dependency pinning and version policies for agent components - Building provenance chains for agent plugin promotion (dev → staging → production) - Any request like "verify plugin integrity", "generate manifest", "check supply chain", or "sign this plugin"

All agent skills → · MCP servers