YAML to Markdown Converter
Convert YAML into a GitHub-flavored Markdown table. Paste a YAML list of mappings (or a single mapping) and get ready-to-paste Markdown.
Recommended Settings
Pro Tips
- •A single YAML mapping is treated as one row; a YAML list of mappings becomes multiple table rows
- •If entries have different sets of keys, the table includes the union of all columns found
- •Pipe characters inside values are automatically escaped so they don't break the table structure
- •Nested objects or arrays inside a value are serialized as JSON text within that cell
- •The whole document is parsed locally in your browser using js-yaml - nothing is uploaded anywhere
Most Popular
Most users paste a YAML list of records to drop straight into a README or wiki page
When to Use This Tool
Turn a YAML data file or config list into a Markdown table for technical documentation or a knowledge base article.
Convert a YAML list of features, options, or settings into a table for a project's README.md.
Generate Markdown tables for wikis (GitHub, GitLab, Notion-compatible exports) directly from existing YAML data.
Paste YAML config changes as a Markdown table into a pull request or issue description without manually formatting it.
How It Works
Parse the YAML input using the js-yaml library, which fully supports the YAML spec including anchors and multi-line strings
Normalize the result into an array of records - wrapping a single mapping into a one-item array if needed
Compute the union of all keys found across every record to build the table header
Escape pipe characters and strip line breaks from each cell, serializing nested values as JSON text
Assemble a GitHub-flavored Markdown table with a header separator row
100% Private
Files never leave your device. All processing happens locally in your browser.
Lightning Fast
Powered by js-yaml for optimal performance on modern browsers.
Open Source
Built with verified, open-source libraries. Fully transparent.
Frequently Asked Questions
What YAML structures does this tool support?
It accepts a single YAML mapping (converted to a one-row table) or a YAML list of mappings (converted to a multi-row table). Scalars or lists of scalars aren't supported since a table needs field names.
What happens to pipe characters in my data?
Any literal | character inside a value is automatically escaped as \| so it doesn't get mistaken for a column separator.
How are nested objects and arrays handled?
A nested object or array value is serialized as a compact JSON string within its cell, since Markdown table cells can only hold flat text.
Is my YAML uploaded to a server?
No. The entire document is parsed locally in your browser using the js-yaml library. Your data never leaves your device.
What happens with invalid YAML?
The tool shows the specific YAML syntax error reported by js-yaml, including the line and column where the problem was found.