Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Test suite for Markdown implementations

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 Implementations
Octocat-spinner-32 Markdown.mdtest
Octocat-spinner-32 PHP Markdown Extra.mdtest
Octocat-spinner-32 PHP Markdown.mdtest
Octocat-spinner-32 .gitmodules
Octocat-spinner-32 License.text
Octocat-spinner-32 Readme.md
Octocat-spinner-32 index.php
Octocat-spinner-32 mdtest.php
Readme.md

MDTest

Markdown/Markdown Extra Test Suite

Introduction

MDTest is a Markdown test suite derived from the older MarkdownTest by John Gruber. MDTest is primarily used for the developement of PHP Markdown but is strucutred in a way that can test and benchmark various implementations.

Test Suites

MDTest splits its tests into "mdtest" folders. The MDTest command line tool will run the test for the specified test suite if specified, or all of them if unspecified.

Markdown.mdtest

The Markdown test suite folder contains the original Markdown test suite from MarkdownTest. It was written by John Gruber to test Markdown.pl.

PHP Markdown.mdtest

The PHP Markdown test suite folder contains complementary tests for PHP Markdown not included in the Markdown test suite.

PHP Markdown Extra.mdtest

The PHP Markdown Extra test suite folder contains tests for features added to PHP Markdown Extra and not present in regular Markdown.

Requirement

This library package should be run with PHP 5.3 or later.

Usage

Command Line

To run MDTest you need a Markdown parser. You can supply the parser as a function to call after loading a PHP library or as an executable script taking input from STDIN and emiting its output to STDOUT.

For instance, if you are testing PHP Markdown, use this command:

./mdtest.php -f \\Michelf\\Markdown::defaultTransform

This will make MDTest autoload the \Michelf\Markdown class and call its defaultTransform static method. (Note that you need to escape backslashes on the shell by prefixing them with another backslash. You may also want to run git submodule init to get PHP Markdown Lib installed in your Implementations folder.)

For external scripts that need to run as a separate process you pass the path to the script instead:

./mdtest.php -s path/to/parser-executable

By default, MDTest will run tests from all folders with a .mdtest extension it can find in the current directory. If no script or function is specified, it tries to

Use the -? option to get a complete list of available options.

Web Interface

The index.php file provides a rudimentary web interface for MDTest. It let you choose from a list of implementations in the Implementaiton folder and displays the output of the test script.

Bugs

Please file bugs in the Github issue tracker.

Copyright

MDTest
Copyright (c) 2007-2013 Michel Fortin
http://www.michelf.com/

Derived from Markdown Test
Copyright (c) 2004 John Gruber
http://daringfireball.net/projects/markdown/

Includes PHP Diff
Copyright (c) 2003 Daniel Unterberger
Copyright (c) 2005 Nils Knappmeier

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

Something went wrong with that request. Please try again.