Intro to TOML

I wrote an introduction to TOML, which I recommend as the configuration language for Hugo. It’s new to a lot of people, so try reading my intro doc, it’ll get you started.


Interesting reading, thank you. It seems as if TOML definitely is the way to go, and should be the preferred language to use. I think this should be reflected in the docs as well, as it is now you can’t really tell which is the recommended way.

For instance, this page only displays an example in YAML: If there’s only one example, I think it should be in the preferred language.

I definitely think that toml is the least error-prone and therefore most newbie-friendly of the configuration languages.

I’d actually like to see 3 versions for every example. We can make toml the default and keep the others behind expandable sections.

I think that’s an excellent idea. Or maybe three tabs for every example, each in the different language (and TOML as the first one shown by default)?

Here was an old post of mine from google groups on toml. Good tip is the online translaters json yaml toml. It got around the fact that the example I needed was in yaml but I wanted toml. Maybe no need to have the 3 versions then?

I’m using toml exclusively with Hugo!searchin/hugo-discuss/toml/hugo-discuss/imwpsYbdLMs/mY8o7BJFIDQJ

1 Like

Hi, does anyone know how to run a TOML config file? I cannot get past that part as my windows machine keeps asking me what I would like to open it with.

Any guidance would be greatly appreciated.



You don’t run a TOML file. Open it with Notepad or whatever text editor you prefer and you set the options that are interpreted by Hugo.

Thanks for taking the time to respond Derek, it’s greatly appreciated. Dan Hersham (creator of the Hugo course on Udemy course which is actually great I am just having difficulty getting started) has pointed me in the direction of Sublime text
It seems good but after setting the options and running hugo in my command prompt it does not seem to work. Any advice on what to check for?