Package

@gr2m/gray-matter

Parse front-matter from a string or file. Fast, reliable and easy to use. Parses YAML front matter by default, but also has support for YAML, JSON, TOML or Coffee Front-Matter, with options to set custom delimiters. Used by metalsmith, assemble, verb and

v4.0.3-with-pr-137, 18 Feb 2022MITCommonJSTypes: BundledParsers and serialisers Markdown

$ npm install @gr2m/gray-matter

npm GitHub Homepage

Key numbers

As of 25 Sept 2026

Weekly downloads: 2.6k; - over 12 months
Gzip bundle size: -; No Bundlephobia data
Dependencies: 4; Direct, from package.json
Last release: 4 years ago; v4.0.3-with-pr-137
GitHub stars: 4.5k; 169 forks
Open issues / PRs: 54 / 27
Contributors: -
Commits, last 52 weeks: 0

Downloads

No weekly download data in the snapshot.

2,556 downloads last week, 12,995 in the last month. No 52-week series has been fetched yet.

Maintenance

Releases, last 12 months: -
Latest version: 4.0.3-with-pr-137, 18 Feb 20224 years ago
First published: -
Last push to GitHub: 14 Jun 2025467 days before the snapshot
Repository archived: No
Open issues: 54
Open pull requests: 27
Commits, last 52 weeks: 0
Dependents on npm: 0

Major versions

Recent releases

Compatibility

Module format: CommonJSFrom package.json type, main and exports fields
TypeScript types: Bundled
Node.js engine range: >=6.0
Runtimes: -
Unpacked size (npm): 38 kB
Dependencies (4): js-yamlkind-ofsection-matterstrip-bom-string

Install

npm install @gr2m/gray-matter

CDN

jsDelivrhttps://cdn.jsdelivr.net/npm/@gr2m/gray-matter@4.0.3-with-pr-137/
unpkghttps://unpkg.com/@gr2m/gray-matter@4.0.3-with-pr-137/
esm.shhttps://esm.sh/@gr2m/gray-matter@4.0.3-with-pr-137

Alternatives

Package	Weekly downloads	Gzip	Last release	Module	Comparison
@11ty/gray-matter Parse front-matter from a string or file. Fast, reliable and easy to use. Parses YAML front matter by default, but also has support for YAML, JSON, TOML Front-Matter, with options to set custom delimiters. Used by metalsmith, assemble, verb and many other	429.3k	-	1 month ago	CommonJS	-
@docmd/live Browser-based editor engine for docmd.	10.3k	-	3 days ago	ESM only	-
metalsmith An extremely simple, pluggable static site generator.	21.2k	-	7 months ago	-	-
micromark-extension-frontmatter micromark extension to support frontmatter (YAML, TOML, etc)	5.4m	-	3 years ago	ESM only	-
mdast-util-from-markdown mdast utility to parse markdown	40.6m	-	7 months ago	ESM only	-
csv-to-markdown-table JavaScript/Node.js Csv to Markdown Table Converter	32.5k	-	14 days ago	ESM + CommonJS	-
@ts-stack/markdown A full-featured markdown parser and compiler, written in TypeScript	28.6k	-	3 years ago	ESM + CommonJS	-
@textlint/fixer-formatter textlint output formatter for fixer	128.3k	-	1 month ago	CommonJS	-

Sources: npm registry, GitHub API. Data fetched 25 Sept 2026.

Indexability: Not indexed (discovery only): downloads_week 2556 < 10000.