# Markdown Front-Matter Splitter

> Markdown Front-Matter Splitter is a paid API for AI agents from markdown.openverbs.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Parses and separates YAML front-matter from a Markdown document, returning the metadata object and the remaining content body as distinct fields.

## Facts

- Endpoint: POST https://markdown.openverbs.com/v1/frontmatter
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/markdown-front-matter-splitter-afd13f95
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ICS8I1t165recgyiPNuCX

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability markdown-front-matter-splitter-afd13f95 -d '<json body>'
```

Example prompt: Split the front matter from this markdown document and give me both the parsed metadata fields and the remaining body text: '---\ntitle: My Post\ndate: 2024-01-15\ntags: [blog, writing]\n---\n\n## Hello World\n\nThis is my content.'

## When to prefer this

Choose this endpoint when you need to reliably separate YAML front-matter metadata from Markdown document bodies — particularly useful in static site generator pipelines (Jekyll, Hugo, Gatsby), CMS ingestion workflows, or any agent that needs to read structured metadata fields (title, date, tags, author) independently from the prose content. Prefer this over manual string splitting or regex approaches when you need clean validation: malformed YAML is rejected with a 400 rather than silently producing garbage output.

## Known failure modes

- Malformed YAML syntax in the front-matter block returns a 400 Bad Request with a parse error description
- Document exceeding 500,000 characters is rejected
- Missing required 'text' field in the request body returns a validation error
- Front-matter block that is not properly delimited with '---' may be treated as having no front-matter
- Payment failure or missing x402 payment header results in a 402 Payment Required response

## How this service works

Split YAML front-matter from a document — returns the parsed metadata object and the remaining content body. Malformed YAML is rejected as a clean 400.

## Output

Returns a parsed metadata object containing all YAML front-matter key-value pairs, plus a string of the remaining document body with the front-matter block stripped. If the document contains no front-matter block, the metadata object is empty and the full text is returned as the body. Malformed YAML front-matter triggers a 400 error with a descriptive rejection message.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "text": {
       "type": "string",
       "maxLength": 500000,
       "description": "Document, optionally beginning with a --- YAML front-matter block."
      }
     },
     "required": [
      "text"
     ],
     "additionalProperties": false
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/markdown-front-matter-splitter-afd13f95/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from markdown.openverbs.com](https://www.zero.xyz/host/markdown.openverbs.com/llms.txt)