# extract-frontmatter <!-- omit in toc -->
- [Overview](#overview)
- [Versioning](#versioning)
- [Repository information](#repository-information)
- [Usage](#usage)
## 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://gitlab.com/isekai/libraries/rust/extract-frontmatter/-/pipelines/main/latest)
[](https://docs.rs/extract-frontmatter)
[](https://gitlab.com/isekai/libraries/rust/extract-frontmatter/-/pipelines/main/latest)
[](https://crates.io/crates/extract-frontmatter)
[](https://crates.io/crates/extract-frontmatter)
[](https://crates.io/crates/extract-frontmatter/reverse_dependencies)
[](https://crates.io/crates/extract-frontmatter/4.1.0/dependencies)
[](https://gitlab.com/isekai/libraries/rust/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
## Usage
Example usage is available on [docs.rs].
[docs.rs]: https://docs.rs/extract-frontmatter/4.1.0/extract_frontmatter/struct.Extractor.html