About these notes

Use plain text files for note-taking


Tools change all the time. In 2012 every productivity guru was using Evernote. In 2023 Notion, Obsidian, Roam are all the hype, and in 10 years it will be something else.

I think of these Notes as a lifelong thinking partner. Proprietary file formats lock you into specific software ecosystems, and cloud-based solutions keep give the data authority to third-party. Files-should-outlive-the-application.

Use plain text files 1 for your notes:

  • They are universally compatible, and will never become unsupported or deprecated. They worked on a computer 50 years ago, and will probably work on one 50 years from now.
  • They are portable. They work on every device.
  • You can choose to sync them through any cloud solution along with having them locally.
  • You can work with them on any editor that is currently in fashion.
  1. Markdown, HMTL, Latex, … 

← back

Links to this note

Files should outlive the application

Software lasts on average 6-8 years, with exceptional and complex software lasting on average 15 years 1. S&P500 companies last 21 years 2. Applications are ephemeral. Using standardized formats ensures...

Linked Notes Should Be Searchable

To use Writing-as-a-user-interface-that-facilitates-thinking effectively, we should be able to find information flexibly in our notes. We should be able to do searches similar to: FIND notes that contain "deep learning"...

Notes Should Be All In One Place

You remember having this flash of insight two weeks ago, and you remember you wrote it down somewhere. You are now looking for it. Is it in your Apple Notes?...

Technical implementation details of linked notes

Use plain text files for note-taking Keep all notes in a single folder Default note titles to a UID and think of a name later. Notes-can-store-structured-information-in-YAML-header Note types help separate...