Convert YAML to MD

Turn YAML files into Markdown. GitHub-flavored Markdown that escapes what Markdown would read as formatting, so values such as *note*, # or <b> show as written; a value with line breaks keeps them, and one with indented lines becomes a code block.

Converted in an isolated sandbox on our serversDeleted after 24 hours

Drop YAML files on the dialor turn it to pick what to do

A YAML file as a readable Markdown document.Keys become values, tables and headings. Every key and value is kept as written.

  1. What you get

    One MD file. Each mapping lists its plain values first as key: value. Small mappings and lists of plain values are nested under their key.

    Larger parts follow under headings named after their keys, down to six levels. Below that, they continue as nested lists.

  2. How lists are written

    A list of mappings that hold only plain values becomes one table. It has a column for every key in the order the keys first appear, and numbers are aligned right. A list of lists of plain values becomes a table without a header row.

    The mappings in any other list each get a heading, numbered from 1.

  3. What stays as written

    Every key and value is kept exactly as the file has it. Long numbers are not rounded, and dates stay text. Values such as yes, on, 0755, ~ and 2024-03-01 appear as they are. A custom tag such as !Ref stays in front of its value.

    A merge key (<<) stays an ordinary key. Aliases are expanded. Comments are dropped.

    A file with several documents becomes a numbered list.

  4. When it stops

    A file with more than 100,000 values fails with resource_limit. A key repeated in one mapping fails with input_corrupted.

    For other paths, see every YAML conversion or every MD conversion.

YAML and MD.What each format is.

The formats

From · YAML

YAML

YAML configuration and data files.

Extensions
.yaml .yml
MIME type
application/yaml
Kind
Text and data
To · MD

Markdown

Plain text with light markup for headings, lists, links and code. What agents and developers write in.

Extensions
.md .markdown .mdown
MIME type
text/markdown
Kind
Text and data

In your code.The same YAML to MD conversion through the API, for your app or your agent.

terminal
$ cv convert report.yaml report.md
$ cv convert report.yaml report.md

Questions.What people ask about YAML to MD.

01OF 04

No. Comments are dropped. Keys and values are kept.

No. Values such as yes, on, 0755, ~ and 2024-03-01 are written as they appear in the file. Dates stay text.

The documents become a numbered list in the one MD file.

A key is repeated in one mapping. The conversion stops with input_corrupted when that happens.

More conversions.Other ways in and out of YAML and MD.