PHPackages                             dpwlabs/yii2-markdown-pages - 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. [File & Storage](/categories/file-storage)
4. /
5. dpwlabs/yii2-markdown-pages

ActiveYii2-extension[File & Storage](/categories/file-storage)

dpwlabs/yii2-markdown-pages
===========================

A simple flat-file Markdown renderer

2.2.2(8y ago)028BSD-3-ClausePHPPHP >=7.0

Since May 25Pushed 8y ago1 watchersCompare

[ Source](https://github.com/RAvenGEr/yii2-markdown-pages)[ Packagist](https://packagist.org/packages/dpwlabs/yii2-markdown-pages)[ Docs](https://github.com/RAvenGEr/yii2-markdown-pages)[ RSS](/packages/dpwlabs-yii2-markdown-pages/feed)WikiDiscussions master Synced today

READMEChangelog (5)Dependencies (6)Versions (10)Used By (0)

Yii2 Markdown Pages
===================

[](#yii2-markdown-pages)

yii2-markdown-pages provides a simple way to write pages in individual Markdown files with YAML frontmatter, render them on the fly and use the rendered HTML and frontmatter however you like.

Give updates on your Yii2 site or have a list of posts for a simple blog or news feed. Store your posts in version control with the rest of your code. **No database required!**

This extension was forked from CorWatts/yii2-markdown-files

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

[](#installation)

Install via composer:

```
composer require 'dpwlabs/yii2-markdown-pages'
```

Configuration
-------------

[](#configuration)

Enable the module by adding the snippet below to your main.php configuration file.

```
'modules' => [
  'pages' => [ // name this module what you like
    'class' => \dpwlabs\MarkdownPages\Module::className(),
    'pages' => '@frontend/views/markdown/pages',
    'drafts' => '@frontend/views/markdown/drafts',
  ]
],
```

- `class`: is the namespaced class for this module
- `pages`: is a path pointing to the directory containing publishable markdown files. The path can contain Yii2 aliases.
- `drafts`: is a path pointing to the directory containing markdown files that aren't quite ready for publishing. The path can contain Yii2 aliases. **Drafts are only rendered in the Yii2 `dev` environment.**

**Note:** If you're going to use the included console command ensure this configuration is added somewhere the console application can access (like `common/config/main.php`).

Usage
-----

[](#usage)

Before rendering and displaying posts the individual post files must be created. A simple way to scaffold new posts is using the console command included in this extension. See below for instructions on how to set it up and use it.

It is easy to create new posts *without* the included console command. Posts follow a specific ruleset:

- Create a file in the `pages` or `drafts` directory path specified in the module configuration above.
- Similar to Jekyll, the filename has a specific format. It should start with the date (YYYY-MM-DD format) followed by a snake\_cased description, and ending with the `.md` extension. Something like `2017-05-20_test_post_1.md`. When these files are processed the date is extracted from the filename. The rest of the descriptive filename is used to select when using the `page()` method.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 56.3% 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 ~38 days

Recently: every ~8 days

Total

9

Last Release

2969d ago

Major Versions

1.0.1 → 2.0.02017-06-16

PHP version history (2 changes)1.0.0PHP >=5.6

2.0.0PHP >=7.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/18cb2935da43ece03704370e04a8f0738edfdced5c04d4c0a73b307ef79d93f2?d=identicon)[RAvenGEr](/maintainers/RAvenGEr)

---

Top Contributors

[![RAvenGEr](https://avatars.githubusercontent.com/u/1021208?v=4)](https://github.com/RAvenGEr "RAvenGEr (9 commits)")[![CorWatts](https://avatars.githubusercontent.com/u/220260?v=4)](https://github.com/CorWatts "CorWatts (7 commits)")

---

Tags

filemarkdownyii2blogflat

###  Code Quality

TestsCodeception

### Embed Badge

![Health badge](/badges/dpwlabs-yii2-markdown-pages/health.svg)

```
[![Health](https://phpackages.com/badges/dpwlabs-yii2-markdown-pages/health.svg)](https://phpackages.com/packages/dpwlabs-yii2-markdown-pages)
```

###  Alternatives

[liyunfang/yii2-upload-behavior

Upload behavior for Yii 2

161.7k](/packages/liyunfang-yii2-upload-behavior)

PHPackages © 2026

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