wpreadme2markdown/wp2md

This package is abandoned and no longer maintained. No replacement package was suggested.

CLI tool for converting WordPress Plugin readme.txt to Markdown

4.2.0 2026-06-12 17:43 UTC

Requires

• php: ^8.1
• composer-runtime-api: >= 2.0.0
• guzzlehttp/guzzle: ^7.3
• symfony/console: ^6 || ^7 || ^8
• wpreadme2markdown/wpreadme2markdown: ^5.0

Requires (Dev)

• ext-json: *
• indeyets/pake: ~1.99
• php5friends/polyfill-create_function: ^0.0.4
• secondtruth/phar-compiler: ~1.1
• squizlabs/php_codesniffer: *

MIT

• Benjamin J. Balter
• Christian Archer

• markdown
• wordpress
• converter
• readme

README

The project is retired, my main reasons are:

• I no longer use WordPress and develop plugins for it
• I now agree with the idea that GitHub's readme and WordPress readme serve different purpose and should therefore be different
• I see an effort from WordPress to prevent some features of this tool from working (screenshot detection)

Convert WordPress Plugin Readme Files to GitHub Flavored Markdown. The tool is built on the WP Readme to Markdown Library

Features

• Converts headings
• Formats contributors, donate link, etc.
• Inserts screenshots

Usage

# with files as params
wp2md -i readme.txt -o README.md
# or with unix pipes
wp2md < readme.txt > README.md

Installation

Composer (recommended)

Add a composer dependency to your project:

"require-dev": {
    "wpreadme2markdown/wp2md": "*"
}

The binary will be vendor/bin/wp2md

Download binary

You may install WP2MD binary globally

sudo wget https://github.com/wpreadme2markdown/wp2md/releases/latest/download/wp2md.phar -O /usr/local/bin/wp2md
sudo chmod a+x /usr/local/bin/wp2md

PHAR compilation

# install dependencies
composer install
# run pake build script
composer pake phar

Executable PHAR archive will be created as build/wp2md.phar

• This assumes composer is installed as a package in your operating system. If not, replace composer with php command and your composer.phar location (i.e. php ../phars/composer.phar)

Web Version

Visit this GitHub page for the web version and a link to its running instance