What does the root = true line do?

It tells EditorConfig-aware editors to stop searching parent directories for more .editorconfig files. You set it in the top-level file at your repository root so its rules are the final word for the project.

How do the [*] and file-specific sections interact?

The [*] block applies to every file, then more specific sections like [*.md] or [Makefile] override it for matching files. Later, more specific matches win, so you set sensible defaults and only override where a file type needs it.

Why must Makefiles use tabs?

GNU Make requires recipe lines to begin with a literal tab character; spaces cause a 'missing separator' error. The Makefile override forces indent_style = tab so the file stays valid even if your default is spaces.

Why keep trailing whitespace in Markdown?

In Markdown, two trailing spaces at the end of a line create a hard line break. Trimming them would silently change rendered output, so the Markdown override sets trim_trailing_whitespace = false.

Do editors apply this automatically?

Many editors (such as VS Code, JetBrains IDEs and Vim with a plugin) read .editorconfig natively or via an extension, applying the rules as you type and save. Check your editor's EditorConfig support if rules are ignored.

.editorconfig Builder

Email me this result

Get this tool's output sent to your inbox, plus one useful tool a week. No spam, unsubscribe any time.

The .editorconfig builder generates a valid EditorConfig file so every contributor’s editor uses the same indentation, line endings and whitespace rules — regardless of personal settings. Choose your base style, add file-type overrides, then copy or download a ready-to-commit file.

How it works

EditorConfig files are read top-down. The builder always emits root = true followed by a [*] section that applies to every file: indent_style, indent_size, end_of_line, charset, trim_trailing_whitespace and insert_final_newline. Editors then apply more specific sections on top — so a [*.md] or [Makefile] block overrides the [*] defaults only for matching files. Because later, more specific matches win, you set sane global defaults once and override only where a file type genuinely differs.

File-type overrides

Three common overrides ship as toggles. [Makefile] forces indent_style = tab because GNU Make requires literal tabs in recipes. [*.{yml,yaml}] pins 2-space spaces because YAML disallows tab indentation. [*.md] sets trim_trailing_whitespace = false because trailing spaces in Markdown create hard line breaks that must be preserved.

Tips

Place the file named .editorconfig at the root of your repository with root = true so it is the authoritative config. Most modern editors support EditorConfig natively or via a small extension — install it if your rules seem ignored. Pair .editorconfig (whitespace and encoding) with a formatter like Prettier or dotnet format (full code style) for complete consistency.