Convert YAML to TOML
Turn YAML into a valid TOML file. Maps become tables, lists of maps become arrays of tables, and anything TOML cannot hold is reported. All in your browser.
- No usage limits
- Your data stays local
- Tables and arrays
- Nulls reported
- Runs on your device. Files are never uploaded.
- Free and unlimited. No sign-up, no watermark.
YAML to TOML in three steps
No account, no email, no waiting for an upload.
- STEP 01
Drop in your YAML
Use a .yaml, .yml or .txt file.
- STEP 02
Decide about dates
Leave 'Write date and time strings as TOML dates' on to turn ISO values into real TOML dates.
- STEP 03
Copy or download the TOML
The note lists any changes, such as nulls left out.
What YAML to TOML does, and what it doesn't
We'd rather tell you up front than surprise you after the download.
What you get
- Tables and arrays of tablesNested maps become [section] headers, and lists of maps become repeated [[section]] headers.
- Date supportISO dates and times become TOML date and time values. Switch this off to keep them as strings.
- Clear notes on lossesTOML has no null. Null values are left out and counted in the note.
- Top-level lists handledA YAML list at the top is placed under an 'items' key, because TOML must start with keys.
- Multi-document filesSeveral YAML documents are read as a list and placed under items.
Good to know
- Comments are lostThey are not part of the data. Add them to the TOML by hand.
- Anchors are expandedTOML has no aliases, so repeated data is written out in full.
- Top level must be a mapA single scalar cannot be written as TOML.
Your data never leave your device
The tool runs inside your browser instead of on our servers, so there is nothing to upload, store or delete afterwards.
Typical online tool upload
Your file travels over the internet, sits on someone else's computer for a while, and you wait for the upload and the download.
Mediaextractr no upload
The tool loads into your browser once, then works on your file locally. Nothing is sent, so nothing can leak.
When people use YAML to TOML
Migrate tool configs
Move settings to a tool that reads TOML.
Draft a pyproject or Cargo section
Start from YAML you already have.
Compare config styles
See how your data reads in both formats.
Learn TOML
Convert known YAML to see the equivalent.
Mediaextractr vs typical upload tools
| MediaextractrPrivate | Typical upload tools | |
|---|---|---|
| Your file is uploaded | Never | Yes |
| Sign-up needed | No | Often, after a few files |
| Daily file limit | None | Often 1–2 free files |
| Watermark | Never | Sometimes |
| Wait for upload & download | No | Yes |
| Speed on very large files | Depends on your device | Depends on their servers |
What changes between YAML and TOML
Both are configuration formats, but TOML is stricter. It has real date types, a defined way to write tables, and no null. YAML allows nested structures anywhere, anchors and several documents per file.
The converter keeps the data and rewrites it in TOML's style. Where TOML cannot express something, the note tells you.
Things to check
Review the output for these points:
- Keys that were null are gone. Replace them with an explicit value in the YAML first.
- Strings that look like dates may be turned into date values. Turn the option off if they should stay text.
- Mixed-type arrays are allowed in TOML 1.0, but some older parsers reject them.
- Convert further with TOML to JSON or go back with TOML to YAML.
Migrating a whole file
Convert section by section when a file is long, so you can check each table. Look at keys with null values in the note, and decide on defaults. After converting, load the TOML in the tool that uses it, to see that it starts. The TOML to JSON converter can confirm the data matches what you had.
Questions, answered
How do I convert YAML to TOML?
Paste the YAML and copy the TOML it creates.
Why are some YAML keys missing from my TOML?
Keys whose value was null are dropped, since TOML cannot store null. The conversion note counts them so you can add real values.
Is the config I convert uploaded?
No. The conversion runs in your browser tab and the YAML is not sent to a server.
Why did my date string become a TOML date?
ISO-style strings are written as TOML dates. Turn the option off to keep them as text.
What if my YAML is a list?
It is placed under an items key, since a TOML file must begin with keys.
Is converting in a mobile browser reliable?
Yes, the same code runs in current mobile browsers, though editing the result is nicer on a computer.