jonschlinkert/gray-matter
Smarter YAML front matter parser, used by metalsmith, Gatsby, Netlify, Assemble, mapbox-gl, phenomic, vuejs vitepress, TinaCMS, Shopify Polaris, Ant Design, Astro, hashicorp, garden, slidev, saber, sourcegraph, and many others. Simple to use, and battle tested. Parses YAML by default but can also parse JSON Front Matter, Coffee Front Matter, TOML Front Matter, and has support for custom parsers. Please follow gray-matter's author: https://github.com/jonschlinkert observed · 2026-08-28
Health v2 · maintenance only
44/100
- Activity 26
- Release rhythm 35
- Longevity 100
Flags: no_releases
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.
- gap_med: n/a
- age_days: 4601
- days_rel: n/a
- days_push: 445
- n_releases_24m: 0
Adoption not part of the score
4488 stars · 168 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded
gray-matter is a JavaScript library for parsing YAML front matter from strings or files, with support for JSON, TOML, and Coffee front matter and custom delimiters or engines. It is a battle-tested, widely adopted npm package used by tools like Gatsby, Astro, VitePress, and Metalsmith.
Use cases
- parse yaml front matter from markdown files
- extract metadata from blog post markdown
- split front matter and content in nodejs
- parse toml front matter from a string
- build a static site generator that reads front matter
- extract title and slug from markdown documents
When to choose
- you need reliable front matter parsing in a Node.js project
- you need support for multiple front matter formats like YAML, JSON, or TOML
- you want a fast, battle-tested parser used by major frameworks
When to avoid
- you are not working in a JavaScript/Node.js environment
- you need to write or stringify front matter rather than parse it
- you need full markdown rendering, not just metadata extraction
Facets
library · maturity stable
parser serialization developer-tools web-development developer-tools documentation files front-matter yaml markdown toml static-site-generators metadata-extraction nodejs javascript
3 sources
- readme: https://github.com/jonschlinkert/gray-matter · fetched 2026-08-28 · 0258be644079
- homepage: https://github.com/jonschlinkert · fetched 2026-08-29 · 9d92e13033bb
- registry_npm: https://registry.npmjs.org/gray-matter · fetched 2026-08-29 · d1bd6478cb75
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| jonschlinkert/gray-matter | main | 44 |
For agents
markdown · JSON · MCP: product_card(name="jonschlinkert/gray-matter")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem