HUGO-CONVERT-TOTOML(1)

💅 hugo-convert-toTOML — the manual page, but make it make sense

okay so real talk: this is a page from the Hugo Manual, and it's all about hugo-convert-toTOML, which — spoiler — converts your front matter to TOML. bestie, if you've ever opened a .md file, saw +++ instead of --- at the top, and went "wait what", this is your moment. 🌸

---

✨ NAME ✨

hugo-convert-toTOML — Convert front matter to TOML 💖

like, that's it. that's the job. it takes front matter and makes it TOML. iconic behaviour, no notes.

---

🎀 SYNOPSIS 🎀

hugo convert toTOML [flags] [args]

yes the command name has a lowercase to and an uppercase TOML in the middle. it's giving camelCase but make it a command. copy it exactly, don't get creative, i'm begging 🫶

---

🦋 DESCRIPTION 🦋

toTOML converts all front matter in the content directory to use TOML for the front matter.

that's the whole vibe. every single file in your content dir gets its front matter switched over to TOML. one command, whole directory, done. main character energy fr fr ✨

ngl, "all" means all — so if you were only planning on converting one little file, maybe double-check your setup before you hit enter. 🙈

---

🔥 OPTIONS 🔥

• -h, --help[=false] — help for toTOML. your classic "what does this do again" button. defaults to false, obviously, because you don't need help until you do. 😭

---

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these bad boys come from the parent command, so they're riding along whether you asked or not. slay, i guess.

• --clock="" — set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
• --config="" — config file (default is hugo.yaml|json|toml)
• --configDir="config" — config dir
• -d, --destination="" — filesystem path to write files to
• -e, --environment="" — build environment
• --ignoreVendorPaths="" — ignores any _vendor for module paths matching the given Glob pattern
• --logLevel="" — log level (debug|info|warn|error)
• --noBuildLock[=false] — don't create .hugo_build.lock file
• -o, --output="" — filesystem path to write files to
• --quiet[=false] — build in quiet mode
• -M, --renderToMemory[=false] — render to memory (mostly useful when running the server)
• -s, --source="" — filesystem path to read files relative from
• --themesDir="" — filesystem path to themes directory
• --unsafe[=false] — enable less safe operations, please backup first

🚨 okay <red>--unsafe</red> is literally named that. "less safe operations, please backup first" is a direct quote and it's a direct quote for a reason. back. up. first. i'm not playing. 💀

---

🌈 SEE ALSO 🌈

• hugo-convert(1) — the parent command, the origin story, the mothership 🧚

---

and that's the page!! lowkey a short one but she ate. 💅

Hugo 0.169.0 · Oct 2026 — mwah, sending you a forehead kiss, go convert some front matter responsibly and remember to back up before you touch --unsafe. 🍓🫶✨