You could have json and a schema. VSCode for example does this, all settings is just a settings.json but it still has auto-complete inside it so you always know

You could have json and a schema. VSCode for example does this, all settings is just a settings.json but it still has auto-complete inside it so you always know what settings are available.