Yekdown Better

Most SSGs parse frontmatter but don't validate it. Yekdown can sit as a pre-processor: it validates, injects derived fields (e.g., word_count from the Markdown), and outputs clean Markdown for your SSG.

While Obsidian has YAML frontmatter support, it lacks schema validation and cross-file queries. Yekdown can be used as a command-line companion: validate your vault, generate dynamic indexes, or export structured data to CSV for analysis.

Before you can go "better," you must understand the "Yekdown." Standard "breakdowns" are superficial. When a project fails, most teams perform a post-mortem breakdown. They ask: What happened? But this is reactive. yekdown better

A Yekdown is proactive and inverted. Derived from a reversal of "breakdown," it implies a systematic, almost surgical, dissection of a working system to find latent inefficiencies. Most people stop at Level 1 of analysis. To get "Yekdown Better," you must descend to Level 5.

Yekdown integrates with editors like VS Code, Neovim, and Emacs via LSP (Language Server Protocol). When you type --- and start a YAML field, the LSP suggests completions from your schema: author: (string), date: (ISO 8601), tags: (array of strings). This transforms Markdown from a dumb text field into a structured form. Most SSGs parse frontmatter but don't validate it

Traditional Markdown has a critical flaw: it lacks a robust metadata layer. While Pandoc and MultiMarkdown introduced YAML frontmatter (the --- blocks at the top of a file), this metadata is often treated as a second-class citizen—parsed, then discarded after transformation.

Yekdown was born from a specific pain point: data portability. Developers and technical writers found themselves repeatedly writing scripts to extract YAML from Markdown files, validate it, convert it to JSON/TOML, and then re-inject it. This was error-prone and tedious. This subtle inversion has profound implications

Yekdown flips the script. It treats every .md file as a YAML document with a Markdown payload. In other words:

This subtle inversion has profound implications.