# extract-frontmatter <!-- omit in toc -->
- [Overview](#overview)
- [Versioning](#versioning)
- [Repository information](#repository-information)
- [Usage](#usage)
- [Extracting front-matter](#extracting-front-matter)
- [Example](#example)
- [Removing front-matter](#removing-front-matter)
- [Example](#example-1)
- [Split document](#split-document)
- [Example](#example-2)
- [Function overview](#function-overview)
- [Selectors](#selectors)
- [Modifiers](#modifiers)
## Overview
A Rust library that allows a user to extract an arbitrary number of lines of "front-matter" from the start of any
multiline string.
Note that absolutely no parsing of extracted front-matter is performed; this is designed to output its results for
another library to then parse.
[](https://docs.rs/extract-frontmatter)
[](https://docs.rs/extract-frontmatter)
[](https://crates.io/crates/extract-frontmatter)
[](https://libraries.io/cargo/extract-frontmatter)
[](https://gitlab.com/Kage-Yami/extract-frontmatter/-/blob/main/LICENSE)
### Versioning
This project follows [Semantic Versioning principals] starting with `v1.0.0`
[Semantic Versioning principals]: https://semver.org/
### Repository information
This repository is located on [GitLab.com].
[GitLab.com]: https://gitlab.com/isekai/libraries/rust/extract-frontmatter