PHPackages                             davidbadura/markdown-builder - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Parsing & Serialization](/categories/parsing)
4. /
5. davidbadura/markdown-builder

ActiveLibrary[Parsing & Serialization](/categories/parsing)

davidbadura/markdown-builder
============================

Markdown Builder

1.1.1(4y ago)22899.4k—1.7%3[7 PRs](https://github.com/DavidBadura/markdown-builder/pulls)5MITPHPPHP >=7.4CI passing

Since Dec 24Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/DavidBadura/markdown-builder)[ Packagist](https://packagist.org/packages/davidbadura/markdown-builder)[ RSS](/packages/davidbadura-markdown-builder/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (7)Dependencies (6)Versions (17)Used By (5)

Markdown Builder
================

[](#markdown-builder)

[![Mutation testing badge](https://camo.githubusercontent.com/00e8c33c010533aac2cf1c92fcb7237e00faa9a9da758ca0b3c5efa8fc847b8b/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e743f7374796c653d666c61742675726c3d687474707325334125324625324662616467652d6170692e737472796b65722d6d757461746f722e696f2532466769746875622e636f6d25324644617669644261647572612532466d61726b646f776e2d6275696c6465722532466d6173746572)](https://dashboard.stryker-mutator.io/reports/github.com/DavidBadura/markdown-builder/master)[![Type Coverage](https://camo.githubusercontent.com/329b590981e6bfc2c80be728b3e934c391400227283a2c5f7c74c6906b1631b9/68747470733a2f2f73686570686572642e6465762f6769746875622f44617669644261647572612f6d61726b646f776e2d6275696c6465722f636f7665726167652e737667)](https://shepherd.dev/github/DavidBadura/markdown-builder)[![Latest Stable Version](https://camo.githubusercontent.com/8fca26df6702a1838a2f87bf5b1f7da6aafd91376bc2863fe8a990d5e83169ce/68747470733a2f2f706f7365722e707567782e6f72672f44617669644261647572612f6d61726b646f776e2d6275696c6465722f76)](//packagist.org/packages/DavidBadura/markdown-builder)[![License](https://camo.githubusercontent.com/1d11725feb541b9532ccd0f3bbd78cf7421e9e74a4d5a39407e70ed5438f5dde/68747470733a2f2f706f7365722e707567782e6f72672f44617669644261647572612f6d61726b646f776e2d6275696c6465722f6c6963656e7365)](//packagist.org/packages/DavidBadura/markdown-builder)

A simple helper class to create markdown.

Installation
------------

[](#installation)

```
composer require 'davidbadura/markdown-builder'
```

Usage
-----

[](#usage)

```
$builder = new MarkdownBuilder();

$builder
    ->h1('Markdown Builder')
    ->p('A simple helper class to create markdown.')
    ->h2('Install ' . $builder->inlineBold('this') . ' powerfull library')
    ->code("composer require 'davidbadura/markdown-builder@dev'", 'bash')
    ->h2('Todos')
    ->bulletedList([
        'write tests',
        (string)$builder
            ->block()
            ->numberedList(['A', 'B', 'C'])
        ,
        'add more markdown features'
    ]);

echo $builder->getMarkdown();
```

```
Markdown Builder
================

A simple helper class to create markdown.

Install **this** powerfull library
----------------------------------

```bash
composer require 'davidbadura/markdown-builder@dev'
```

Todos
-----
* write tests
* 1. A
  2. B
  3. C
* add more markdown features

```

API
---

[](#api)

The markdown builder have two kinds of elements, block and inline elements. Block elements will be buffered and you can get the markdown if you call the method `getMarkdown()`. All inline Elements are prefixed with `inline*` and you get instantly the markdown output.

### Block Elements

[](#block-elements)

#### h1

[](#h1)

PHP-Code:

```
echo (new MarkdownBuilder())->h1('Hello World')->getMarkdown();
```

Markdown:

```
Hello World
===========
```

#### h2

[](#h2)

PHP-Code:

```
echo (new MarkdownBuilder())->h2('Hello second world')->getMarkdown();
```

Markdown:

```
Hello second world
------------------
```

#### h3

[](#h3)

PHP-Code:

```
echo (new MarkdownBuilder())->h3('My name is...')->getMarkdown();
```

Markdown:

```
### My name is...
```

#### p

[](#p)

PHP-Code:

```
echo (new MarkdownBuilder())->p('paragraph')->getMarkdown();
```

Markdown:

```
paragraph
```

#### blockquote

[](#blockquote)

PHP-Code:

```
echo (new MarkdownBuilder())->blockquote("Foo\nBar\nBaz")->getMarkdown();
```

Markdown:

```
> Foo
> Bar
> Baz
```

#### bulleted list

[](#bulleted-list)

PHP-Code:

```
echo (new MarkdownBuilder())->bulletedList(['Foo', 'Bar', 'Baz'])->getMarkdown();
```

Markdown:

```
* Foo
* Bar
* Baz
```

#### numbered list

[](#numbered-list)

PHP-Code:

```
echo (new MarkdownBuilder())->numberedList(['Foo', 'Bar', 'Baz'])->getMarkdown();
```

Markdown:

```
1. Foo
2. Bar
3. Baz
```

#### hr

[](#hr)

PHP-Code:

```
echo (new MarkdownBuilder())->hr()->getMarkdown();
```

Markdown:

```
------------------------
```

#### code

[](#code)

PHP-Code:

```
echo (new MarkdownBuilder())->code('$var = "test";', 'php')->getMarkdown();
```

Markdown:

```
```php
$var = "test";
```

```

#### table

[](#table)

PHP-Code:

```
echo (new MarkdownBuilder())->table(
    ['col0', 'col1'],
    [
        ['row01', 'row01'],
        ['row10', 'row11'],
    ],
    [Alignment::CENTER, Alignment::RIGHT]
)->getMarkdown();
```

Markdown:

```
|col0|col1|
|:-:|-:|
|row01|row01|
```

### Inline Blocks

[](#inline-blocks)

#### bold

[](#bold)

PHP-Code:

```
echo (new MarkdownBuilder())->inlineBold('Hey!');
```

Markdown:

```
**Hey!**
```

#### italic

[](#italic)

PHP-Code:

```
echo (new MarkdownBuilder())->inlineItalic('huhu');
```

Markdown:

```
*huhu*
```

#### code

[](#code-1)

PHP-Code:

```
echo (new MarkdownBuilder())->inlineCode('$var = "test";');
```

Markdown:

```
`$var = "test";`
```

#### link

[](#link)

PHP-Code:

```
echo (new MarkdownBuilder())->inlineLink('http://google.de', 'Google', 'Title');
```

Markdown:

```
[Google](http://google.de "Title")
```

#### img

[](#img)

PHP-Code:

```
echo (new MarkdownBuilder())->inlineImg('cat.jpg', 'Cat', 'Title');
```

Markdown:

```
![Cat](cat.jpg "Title")
```

### Advance features

[](#advance-features)

if you need collapse blocks, you can create a new builder instance with his own clean buffer. this can you do by call `block()`.

PHP-Code:

```
$builder = new MarkdownBuilder();
$builder->blockqoute(
    (string)$builder
      ->block()
      ->h1('Lists')
      ->bulletedList([
        'Foo',
        $builder->block()->numberedList(['A', 'B', 'C']),
        'Bar'
      ])
);
```

Markdown:

```
>  Lists
>  =====
>
>  * Foo
>  * 1. A
>    2. B
>    3. C
>  * Bar
```

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance58

Moderate activity, may be stable

Popularity47

Moderate usage in the ecosystem

Community22

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 54.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~415 days

Recently: every ~603 days

Total

7

Last Release

1669d ago

PHP version history (3 changes)1.0.0PHP ~5.4

1.0.2PHP >=5.4.0

1.1.0PHP >=7.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/470138?v=4)[David Badura](/maintainers/DavidBadura)[@DavidBadura](https://github.com/DavidBadura)

---

Top Contributors

[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (161 commits)")[![DavidBadura](https://avatars.githubusercontent.com/u/470138?v=4)](https://github.com/DavidBadura "DavidBadura (68 commits)")[![renovate-bot](https://avatars.githubusercontent.com/u/25180681?v=4)](https://github.com/renovate-bot "renovate-bot (61 commits)")[![CaptainFalcon92](https://avatars.githubusercontent.com/u/24324122?v=4)](https://github.com/CaptainFalcon92 "CaptainFalcon92 (4 commits)")[![smoench](https://avatars.githubusercontent.com/u/183530?v=4)](https://github.com/smoench "smoench (2 commits)")

---

Tags

markdownbuilderwriterrender

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Psalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/davidbadura-markdown-builder/health.svg)

```
[![Health](https://phpackages.com/badges/davidbadura-markdown-builder/health.svg)](https://phpackages.com/packages/davidbadura-markdown-builder)
```

###  Alternatives

[erusev/parsedown

Parser for Markdown.

15.0k151.8M732](/packages/erusev-parsedown)[league/commonmark

Highly-extensible PHP Markdown parser which fully supports the CommonMark spec and GitHub-Flavored Markdown (GFM)

3.0k404.0M702](/packages/league-commonmark)[michelf/php-markdown

PHP Markdown

3.5k52.4M345](/packages/michelf-php-markdown)[league/html-to-markdown

An HTML-to-markdown conversion helper for PHP

1.9k28.6M199](/packages/league-html-to-markdown)[cebe/markdown

A super fast, highly extensible markdown parser for PHP

1.0k32.5M136](/packages/cebe-markdown)[premier/markdown-builder

Markdown Builder

1034.9k](/packages/premier-markdown-builder)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)