ninjabachelor/mym-parser

Parse YAML metadata from a markdown document

MYMParser

, _(*1)

Markdown YAML metadata parser. Parse YAML metadata from a markdown document., _(*2)

Installation

Install the latest version with:, _(*3)

$ composer require ninjabachelor/mym-parser

Usage

In order to be parsed, metadata must be placed at the beginning of the markdown document between two triple dashes. Example:, _(*4)

---
title: Lorem ipsum dolor sit amet
author: Marcus Antonius
keywords: latin, ipsum
---

Vestibulum tortor quam, *feugiat vitae*, ultricies eget, tempor sit amet, ante.

Here's how to parse the metadata:, _(*5)

<?php

use Ninjabachelor\MYMParser\Parser;

// Load document source.
$source = file_get_contents('document.md');

// Parse source. Result is a two-element associative array
$result = Parser::parse($source);

// The first element, 'metadata', is the array of parsed metadata. Example:
//
// array(
//     'title'     =>  'Lorem ipsum dolor sit amet',
//     'author'    =>  'Marcus Antonius',
//     'keywords'  =>  'latin, ipsum'
// );
$result['metadata'];

// The second element, 'content', is the document source without metadata. Example:
//
// Vestibulum tortor quam, *feugiat vitae*, ultricies eget, tempor sit amet, ante.
$result['content'];

License

MYMParser is licensed under the MIT License. See the LICENSE file for details., _(*6)

Credits

This library is inspired by daylerees' Kurenai., _(*7)