Convert Markdown to YAML
Convert Markdown to YAML in your browser: load your Markdown, choose YAML as the target, and download the result. The converter reports exactly what it could not carry across, and nothing is uploaded to a server.
Convert Markdown to YAMLRuns in your browser. Nothing uploaded.
When you need this
Turning a documented table of settings into the configuration it describes — the case where a spec table and a config file have drifted apart and you want the document to be the source.
How to convert Markdown to YAML
- Load your Markdown
- Drag the .md file in, or paste just the table you want. There is no need to strip the surrounding prose — only the tables are read. Nothing leaves your browser at this or any later step.
- Choose the target format
- Press Ctrl+Shift+K (Cmd+Shift+K on a Mac) to open the conversion panel, then pick YAML as the target. The source and the result sit side by side.
- Read the loss report
- The panel shows whether the conversion is lossless for your particular data, and lists every value it had to transform. Adjust indentation, key sorting and null handling if you need to.
- Take the YAML
- Download the .yaml file, copy it, or open it as a new tab to keep working on it in the YAML views.
What survives the conversion
Markdown to YAML cannot be lossless, because the two formats express different things. Converts the tables to sequences of mappings.
- Only the tables convert; the surrounding document is not represented.
- Each table becomes a sequence of mappings keyed by the header row.
- Cell values stay strings unless type inference is on. A column of
true/falsein a document is often prose rather than booleans, so nothing is assumed.
A worked example
A settings table as a sequence of mappings:
| key | value |
| --- | --- |
| timeout | 30 |- key: timeout
value: "30"Privacy
The conversion runs in your browser — in a Web Worker for anything above a quarter of a megabyte, so the page stays responsive. Your data is not uploaded, not logged and not stored. There is no account, and the whole thing works offline.
Questions
Why is the number quoted?
Because a Markdown cell contains text, and turning 30 into a number is an assumption about a document that may have meant "30" as prose. Switch type inference on in the conversion panel if the table really does hold numbers — the converter would rather quote a number than change one.
Is converting Markdown to YAML lossless?
No, and no tool can make it so. Converts the tables to sequences of mappings. The converter lists every affected value rather than silently dropping it.
Is my Markdown uploaded to a server?
No. The file is read and converted by your browser. Nothing about its contents is sent anywhere, which you can verify in your browser’s network panel or by using the tool with the network disconnected.