Advice for writing better note titles

People do not realise how important document titles are. I've said before, You should give your notes titles. There are many examples:

Thus, when you have a good document within a PKM system or even a team wiki, how do we write a good and useful title for it?

Qualities we want:

It's worth being aware that the goals and process for writing titles for Notes have very little resemblance to writing Headlines for Stories, Titles for Blog Posts, or Subject Lines for Emails. It in some ways resembles writing titles for Essays.

Guidelines (not rules)

Write in assertive positive form. “X causes Y” is usually better than “X fails to do Z”. For example:

In writing this way you may also learn to be more assertive and sure of yourself.

Phrase unproven notes as questions. Despite my previous advice to be assertive, if you cannot prove something beyond your own doubts, you should phrase it as a question.

Attention Windows users

If you are on Windows, you cannot have question marks in filenames. You'll have to infer that a file is a question, and perhaps rely on title: attributes if you are using Obsidian or Logseq.

Use consistent and correct spelling. I have been tempted many times to ignore spelling errors, but this will bite you in future when you attempt to use the search feature in your notes. Take the time to use a spellchecker and fix errors. For the same reason, you should use only a single region's spelling. Don't mix American and Australian English.

Link to the note. If you are writing in a linked note app such as Obsidian or Tana, you should try finding other notes that relate to this one, and link to them. By considering how another note is related to the current note, this puts you in a mindset to consider a usable title. For example,

Write the document. Titles tend to emerge from the document as it is written. You may realise on writing the body, you cannot deliver on the promise of your original title. Changing the title then becomes obvious. You may also realise on writing the title, that no single title can encapsulate all you have written. This is a good indicator that your note should be broken apart into atomic notes.

Consider characters you can't type. I am unable to easily type “Gonçalo” with my keyboard. So my note for such a person has an alias “Goncalo”.

Look at similar notes. One way to find them is in a Taxonomy of note types. You may notice interesting and useful conventions, such as How To guides beginning with the words “How to–”.

Search for it. Instead of opening a folder to reach your document, try using search to find it. The simple act of typing words into a search box leads you to think about what words might be suitable for your title.

Rewrite your titles. No matter how smart you think you are, your future self will come up with and encounter brilliance that present you is not capable of. For instance, I thought myself clever for coming up with this title:

Anti guidelines

These are guidelines I've seen recommended by others, which I believe you should approach with great caution.

Move important words earlier. What is important in one circumstance may not be in another. Consider these two sentences:

Front end codebases is more important in the first, and Typescript is more important in the second. Sometimes it may be worth fussing over moving words earlier, but you can waste a great deal of time without making meaningful progress.

Arbitrary title length limits, such as "Keep titles under 10 words". have been a waste of time in my experience. Yes, it can be argued there is great satisfaction in reducing a title down to a catch-phrase or concept-handle like length. Where we waste time is the number - hours can be lost musing whether the number is 10 or 12, or if a very complex title can be honed down sufficiently.

Use Numbers. Some believe that numbers in titles makes them more interesting and assertive. I believe them to be clickbait-y and low class. Consider these examples:

They have some advantages, namely that they give you some idea of how large the note is. On the downside, they reek of lower class writing, and they are also not very Searchable. Who can remember to search for the number "73"? And every time we change the body we have to update the number!

Exaggerate and appeal to emotion. There are many words that are charged excessively with emotion, to the point of being upsetting or aggravating. Avoid these. For example:

Name drop. It has become popular in PKM blogs and videos lately to hijack the fame of others by mentioning their names in titles. You should keep this to a minimum as doing this tends to stifle your own thinking.

Other people's thoughts

In putting together this note, I read many others. Here are some of the best:

Bryan Jenks - A structured approach to processing diverse inputs - Bryan Jenks and his Obsidian KMS

Andy Matuschak:

University of Minnesota - Writing an Effective Title

How to title your art