A document you can still open

The speech is finished. The event has happened. Six years later, someone asks for a copy, and the useful question is no longer whether your writing app had a particularly elegant toolbar. It is whether you can open the file.

That is a good place to start with Markdown. Before learning the symbols, consider the object they produce: a text file containing your words and a small amount of visible structure. A heading might begin with #. A list item might begin with a dash. An ordinary text editor can show both without knowing anything about the app that created them.

This sounds unremarkable. For writing you intend to keep, unremarkable is quite an advantage.

The file and the view are different things

A Markdown file usually ends in .md or .markdown. Inside, a short document might look like this:

# The leaving speech

Thank you to everyone who made the place feel welcoming.

## Remember to mention

- The first exhibition
- The borrowed chairs
- Jo's excellent, terrible coffee

A formatted editor can show the title as a title and the bullets as bullets, without leaving the punctuation in the way. A text editor shows the notation. These are two views of the same writing, rather than a polished document and a separate transcript you have to maintain.

For a letter, essay, set of study notes or project explanation, that can be enough. You can concentrate on sentences while the file retains a structure another compatible tool can interpret. If you prefer a formatted view, Clarity is a Mac editor for ordinary Markdown files; its getting started guide covers creating one or opening a file you already have.

Plain text has boundaries

The simplicity is real, but it is not magic portability. Different Markdown tools support different additions. A table, footnote or piece of embedded HTML may work in one place and behave differently in another. The more elaborate the document, the more useful a test in its intended destination becomes.

Images introduce another distinction. A Markdown document generally contains a reference to an image, not the image itself. Taking the speech file with you is enough for its words; taking an illustrated programme may also mean taking a folder of pictures. Links to websites likewise remain dependent on those websites.

And a readable file is still a file you can lose. Markdown does not supply a backup, settle competing edits or make a failing disk more agreeable. Clarity’s saving and recovery guidance explains its own behaviour, including the need for independent backups.

Try it on something small

There is no need to reorganise years of documents to find out whether this suits you. Start with writing that has a clear, modest shape: a reading response, a recipe with a few observations, a page explaining how a small project works. Use paragraphs, headings and a list only where they help.

Then look at the saved file in a text editor. Can you recognise the structure? Are the words there without an export procedure? If you give the file to someone using a different Markdown tool, does the result remain useful?

A document requiring exact page positioning, complex equations or a publisher’s specialist template may belong elsewhere. The leaving speech probably doesn’t. It needs a title, the words, and somewhere you can find it when Jo asks for a copy.