Pelican YAML Metadata

This Pelican plugin allows articles written in Markdown to define their metadata using a YAML header. This format is compatible with other popular static site generators like Jekyll or Hugo.

It is fully backwards-compatible with the default metadata parsing.

Installation

This plugin can be installed via:

python -m pip install pelican-yaml-metadata

As long as you have not explicitly added a PLUGINS setting to your Pelican settings file, then the newly-installed plugin should be automatically detected and enabled. Otherwise, you must add yaml_metadata to your existing PLUGINS list. For more information, please see the How to Use Plugins documentation.

Usage

This plugin aims to keep things simple. After installing and enabling it, any Markdown files will have the option of defining metadata using a YAML header instead of the standard key/value pairs.

In order to specify metadata using YAML, enclose it within --- lines.

Example:

---
title: Some title
author: Some person
tags:
  - tag 1
  - tag 2
date: 2014-12-25 00:00
summary: The article summary will be __parsed__ as markdown
---

This is some article text.

If the YAML block is not found, the metadata will be parsed using the normal Markdown metadata syntax.

Contributing

Contributions are welcome and much appreciated. Every little bit helps. You can contribute by improving the documentation, adding missing features, and fixing bugs. You can also help out by reviewing and commenting on existing issues.

To start contributing to this plugin, review the Contributing to Pelican documentation, beginning with the Contributing Code section.

License

This project is licensed under the MIT license.