Text Case Best Practices in Markdown
Published 2026-03-01 · convertcase.in
Markdown is widely used for documentation, README files, and content. Here is how to apply case conventions correctly.
Try it now — free instant conversion
No signup · No limits · Works on all devices
1Headings
# H1 and ## H2: Title Case or Sentence case — decide and be consistent. ### H3 and deeper: Sentence case recommended.
2Code in Markdown
Function names, variable names, and code snippets in backticks preserve exact case: `getUserProfile()`, `snake_case_variable`.
3Body Text
Always sentence case. Only capitalise proper nouns, brand names, and the first word of each sentence.
Frequently Asked Questions
Should README headings be title case or sentence case?
Both are common. GitHub's own docs use sentence case. Sentence case feels more modern and is easier to write consistently.