Download the PHP package picas/markdown-extended without Composer

PHP Markdown Extended

Yet another PHP parser for the markdown (extended) syntax.

PHP Markdown Extended is a PHP parser to transform Markdown text files or strings in HTML or other formats. This new version of a Markdown parser tries to follow the extended syntax specifications and is PHP-5.3 compliant and highly customizable.

You can use this package in PHP scripts just as usual (for PHP apps) and also like a standalone command line utility. The CLI interface is interactive with a large set of options and fully documented.

README contents:

• Installation
  • Raw PHP package
  • Using Composer
  • Using a standalone version
    • Locally
    • Personally
    • Globally
• Usage
  • Usage for writers
  • Usage for developers
  • Command line usage
  • Old parsers compatibility
• Open-Source & Community
• License

Installation

You can use this package in your work in many ways. Please note that it requires a running PHP version of 5.3.3 minimum.

Raw PHP package

First, you can clone the GitHub repository and include it "as is" in your project:

You can also download an archive from GitHub:

Then, to use the package classes, you just need to include its bootstrapper which will register its namespaces in current runtime environment:

Using Composer

Another way to use the package, if you are a Composer user, is to add it to your requirements in your composer.json file:

The namespace will be automatically added to the project's Composer's autoloader.

Using a standalone version

Finally, if you plan to use the parser as a single binary, you can use a PHAR archive directly, which embeds the whole source as a standalone binary (~220Kb). Its usage is the same as the bin/markdown-extended script described below.

The archive is stored in a specific phar-latest branch on the repository:

Locally

If you only need the archive for a local project, you can copy it where you want:

Personally

To install the binary in your user's binaries:

Globally

For a complete global install, run:

Usage

An HTML demonstration and the code documentation are available on the "dev" branch.

Usage for writers

To be compliant with the extended Markdown syntax, writers may construct their contents following the rules described at http://cheatsheet.aboutmde.org/ (all basic markdown rules are still available and valid).

For a full example and a test file, you can refer to the demo/MD_syntax.md file of the package ; the latest version can be found at http://github.com/e-picas/markdown-extended/blob/dev/demo/MD_syntax.md.

Usage for developers

The source code documentation of the last stable release can also be found online at http://docs.ateliers-pierrot.fr/markdown-extended/.

The MarkdownExtended package can be simply call writing:

This will load in $content the parsed version of your original Markdown source (file content or string).

The returned $content variable is actually a \MarkdownExtended\API\ContentInterface object but you can write it directly using:

To get the part you need from the content, write:

You can also use the \MarkdownExtended\Parser object as a procedural non-static object (this is in fact what the static methods above really do):

A more complete usage documentation is available in the package's documents (doc/DOCUMENTATION.md). You can read it online at https://github.com/e-picas/markdown-extended/blob/master/doc/DOCUMENTATION.md. Its manpage version is embedded in the package running:

Command line usage

A command line interface is proposed with the package running:

The interface allows to parse one or more files, extract some information from sources, write the results in files and some other stuff. A large set of options are available to customize the transformation.

A complete manpage is available in the package's man/ directory and its markdown source is available in its documents (doc/MANPAGE.md). To read it, run:

The developer documentation is also available as a manpage running:

Examples of cli usage:

Old parsers compatibility

To keep the package compatible with old versions of Markdown, an interface is embedded with the common Markdown($content) function ; to use it, just include the file src/markdown.php of the package:

This way, you may be able to change your Markdown parser without so much work and, I hope so, a better result ;)

Open-Source & Community

This parser is a free software, available under BSD license ; you can freely use it, for yourself or a commercial use, modify its source code according to your needs, freely distribute your work and propose it to the community, as long as you let an information about its first authors.

As the sources are hosted on a GIT repository on GitHub, you can modify it, to ameliorate a feature or correct an error. Please read the CONTRIBUTING.md file of the package for more info.

License

This software, as the original Markdown, is licensed under the terms of the BSD-3-Clause license. Please see the LICENSE file for a full text.

You can use, transform and distribute this software and its dependencies as you wish, as long as you mention the copyrights below:

Markdown  
Copyright (c) 2003-2006 John Gruber   
<http://daringfireball.net/>   
All rights reserved.

PHP Markdown & Extra  
Copyright (c) 2004-2009 Michel Fortin  
<http://michelf.com/>  
All rights reserved.

Multi Markdown  
Copyright (c) 2005-2009 Fletcher T. Penney
<http://fletcherpenney.net/>  
All rights reserved.

PHP Markdown Extended
Copyright (c) 2008-2024 Pierre Cassat & contributors
<http://picas.fr/>  
All rights reserved.