Skip to content
This repository has been archived by the owner on Apr 4, 2020. It is now read-only.

thephpleague/commonmark-extras

Repository files navigation

league/commonmark-extras

Latest Version on Packagist Software License Build Status Coverage Status Quality Score Total Downloads

DEPRECATED

This extension has been deprecated. All of its functionality now exists in league/commonmark 1.3+. You can either register the various extensions individually or use the GithubFlavoredMarkdownExtension to get full GFM functionality, so you should upgrade to that version of league/commonmark and use that instead of this one.

Overview

league/commonmark-extras is a collection of useful GFM extensions and utilities for the league/commonmark project.

Adding this extension to your project will automatically register these sub-extensions:

Extension Purpose
league/commonmark-ext-autolink Automatically creating links to URLs and email address (without needing the <...> syntax)
league/commonmark-ext-smartpunct Intelligently converts ASCII quotes, dashes, and ellipses to their Unicode equivalents
league/commonmark-ext-strikethrough Adds support for ~~strikethrough~~ syntax
league/commonmark-ext-table GFM-style tables
league/commonmark-ext-task-list GFM-style task lists - [x] Like this

Install

Via Composer

$ composer require league/commonmark-extras

Usage

This can be added to any new Environment:

use League\CommonMark\CommonMarkConverter;
use League\CommonMark\Environment;
use League\CommonMark\Extras\CommonMarkExtrasExtension;

// Obtain a pre-configured Environment with all the CommonMark parsers/renderers ready-to-go
$environment = Environment::createCommonMarkEnvironment();

// REGISTER THIS EXTENSION HERE
$environment->addExtension(new CommonMarkExtrasExtension());

// Define your configuration:
$config = [];

// Now that the `Environment` is configured we can create the converter engine:
$converter = new CommonMarkConverter($config, $environment);

// Go forth and convert you some Markdown!
echo $converter->convertToHtml('# Hello World!');

Change log

Please see CHANGELOG for more information what has changed recently.

Testing

$ composer test

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

License

This library is licensed under the BSD-3 license. See the LICENSE file for more information.