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)23965.4k—9.5%3[2 issues](https://github.com/DavidBadura/markdown-builder/issues)[9 PRs](https://github.com/DavidBadura/markdown-builder/pulls)6MITPHPPHP >=7.4CI failing

Since Dec 24Pushed 3w 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 2d ago

READMEChangelog (7)Dependencies (6)Versions (20)Used By (6)

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

54

—

FairBetter than 96% of packages

Maintenance60

Regular maintenance activity

Popularity48

Moderate usage in the ecosystem

Community22

Small or concentrated contributor base

Maturity72

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

1715d 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] (162 commits)")[![DavidBadura](https://avatars.githubusercontent.com/u/470138?v=4)](https://github.com/DavidBadura "DavidBadura (69 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.1k156.8M870](/packages/erusev-parsedown)[league/commonmark

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

3.0k437.5M1.0k](/packages/league-commonmark)[michelf/php-markdown

PHP Markdown

3.5k54.5M379](/packages/michelf-php-markdown)[league/html-to-markdown

An HTML-to-markdown conversion helper for PHP

1.9k32.2M298](/packages/league-html-to-markdown)[cebe/markdown

A super fast, highly extensible markdown parser for PHP

1.0k34.1M148](/packages/cebe-markdown)[premier/markdown-builder

Markdown Builder

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

PHPackages © 2026

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