Build StatusMaintainability

A simple Markdown parser, short and only with the rules there I currently need. The function is regex based and it is possible to enhance your custom rules.

Yes, I know, it give a lot of open projects that solve the same goal. However it was fun to write my custom parser, only with the rules there I need, not to much overhead. Yes, also I mean that other packages more solid solid, lof of usages, bot not points enough to learn about regex and markdown. Besides I know a regex parser is not the best, fastest way, but also here, I would to teach me in this context.

Demo, Tests

The solution is still active in his tests, you find it here. This test of the class is also build as PWA, Progressive Web App. It was only an fun project for me to understand it on a really simple site how it works. But is important, if you see the directory test in this repository here and wounder about so much files there are not in the context of the Markdown parser. If you will check the PWA, use it on your mobile or play with Chrome/WebInspector.

Active use

The class is simple and I use it for my own documentation, there I write in markdown. Here and there is the result a single oage to help in each day to find the right syntax, hints, background and others. You can see this on this examples:


My class supports currently the follow syntax. But Pull Request are really welcome and the solution give you the possibility to add your own rule.



Install static via download, clone the repository or use dependency management via Composer

composer require bueltge/marksimple
You find the solution and the tests in the repository on GitHub.

See the test directory for an example with two different usages. The test directory works as PWA, for examples see only the file index.php.

Code examples

// Example with four spaces.
require_once '../vendor/autoload.php';
use Bueltge\Marksimple\Marksimple;
$ms = new Marksimple();
print $ms->parseFile('../');
// Example Github Code Block `php.
require_once '../vendor/autoload.php';
use Bueltge\Marksimple\Marksimple;
$ms = new Marksimple();
print $ms->parseFile('../');


On the way to the goal of my simple parser I use lot of tests, tries on the online Regex testers. Thanks a lot to the authors of this followed two sites, great!


Copyright (c) 2017 until now, Frank Bültge

Good news, this plugin is free for everyone! Since it's released under the MIT License you can use it free of charge on your personal or commercial website.


All feedback / bug reports / pull requests are welcome.