The Unvarnished Geek

Making Tech Sane Again


Project maintained by UnvarnishedGeek Hosted on GitHub Pages — Theme by mattgraham

The Elegance of Plain-Text Writing

Why Plain Text?

I’ll admit it, I’m a tech nerd. Or, at least, as much of a tech nerd as one is likely to find in an English department.

I’m a scholar of medieval literature by trade. I think medievalists bring a useful perspective to technology: a kind of historical awareness that allows us to be “novelty agnostic,” viewing technology as more of a collection of useful functions rather than a progressive march toward perfection. This approach allows us to ask not “what’s the newest thing?” but rather “what’s the best technology for the job?” in an awareness that the best tool for the job might potentially be a very old one just as easily as the newest one.

One thing all scholars in the humanities do all the time is write, and taking my “medievalist mind” to the available technologies for doing that has enabled me to discover some tools that in some ways are older and less “high tech” than other options, but, for the same reason, are also so much more stable, more sustainable, and so much easier to manage that they’ll make your “modern” office suite seem downright clunky by comparison.

The Elegance of Plain Text

To understand how working in plain text is helpful, think about the tools you normally use to write on a computer. If you’re like most, you default to a traditional “word processor” such as Microsoft Word. But consider this: have you ever had a problem with Word where some strange formatting seems to have infiltrated your document and you can’t get rid of it, no matter what you do or what settings you change? Have you ever had a Word document behave in infuriatingly odd ways for no apparent reason? Well, there is a reason, which is that Word documents are actually extremely complicated beasts. For example, a single sentence in Word might appear to be very simple. However, underneath what you can see, there’s a huge amount of code that you don’t can’t. As an experiment for this post, I typed a single sentence in Word, and then revealed the underlying code: there was over nine pages of code for that solitary sentence.

Hence one big reason Word tends to misbehave, and misbehave more the more you work with a document. As you add edits, elements such as images, copy text from other sources, rearrange blocks of text, add and fiddle with footnotes and endnotes–in other words, most of the things an academic does with documents all the time–the more of that code is inserted and has to interact with previous code, and the more complex it becomes. No wonder your document starts behaving as though it’s possessed by something unholy the more you manipulate it.

On the other hand, a plain-text file contains only the ascii characters that you type. A plain text file in which you type:

This is a simple sentence in plain text.

contains only the characters you typed, nothing else. If you make edits, rearrange things, paste in text from elsewhere, make lots of revisions over time, add sources, etc., you’re only rearranging and addind your text.

While a file from an office suite might (kinda falsely) boast, “what you see is what you get,” a plain-text file can easily affirm that what you see is what is there. No shenanigans.

A few other advantages of plain text:

  • It’s compatible with everything. You can edit plain text files on any device, with any simple text editor. You can work on your writing on any computer, your tablet, or even your phone without screwing up any formatting in the process. You already have a perfectly-capable plain-text editor on your computer if you’re using any common operating system: the venerable Notepad has come budled with Windows for decades, Text Edit is the equivalent for Mac OS. Different Linux distributions come with different small text editors, but tools such as Mousepad and Gedit are common. There are also, of course, many free plain-text editors for Android and iOS only a few clicks away through your preferred app store.
  • It’s sustainable over time. As mentioned above, plain text doesn’t add tons of behind-the-scenes code the more you work with a document, so you can say goodbye to Word’s bloated nonsense. It’s also true that popular file formats change over time: if you wrote documents in something like, say, WordStar years ago, those documents take a lot of doing to access these days. Plain text documents have always been, and will aways be, universally accessible.
  • You can focus on your words. Word tends to be so complex, and presents you with such a dizzying array of options (most of which you don’t need unless you’re a massive law firm or insurance corporation) that the tool itself can distract from your writing. A simple text editor removes all that nonsense–it’s just you and your words.
  • You have more control over formatting, especially when changing styles. The basic idea behind a plain-text workflow is that you do your composing with a text editor in a sustainable, unversal format, and then, only when your text is ready to send somewhere–say, to a journal for publication–do you worry about formatting. We’ll cover how to make this work in later posts, but for now, imagine this: you’ve written an article as a text file. That file contains only universal formatting for everything–subheadings, footnotes, citations, etc. To format the file for different venues, you use another piece of software to convert that document into any format you like. One journal wants the document submitted as a Word document with citations in MLA style? You simply tell your conversion software that’s what you want, and, with a few keystrokes, ZAP! You’ve got a properly-formatted Word document ready to go. Another journal wants same article submitted as a PDF with footnotes using the Chicago notes-bibliography style? A few more keystrokes and voila! Need to make some substantial edits after a peer review? Make those edits in the original text file and avoid all the formatting headaches your word processor always gives you.
  • It’s blazingly fast. Text editors are tiny pieces of software compared to word processors, so they start instantaneously, load documents almost instantly, and run like lightning even on old hardware. Nothing gets between you and your words.

I should mention that this entire blog post was composed in a basic plain-text editor, called Vim, an editor that runs simply in a terminal, and has been around since the late 1980’s! These words have never seen Word, and never will!

Convinced? If so, stay tuned for more posts on working with plain-text writing tools.

Comments powered by Talkyard.

If you enjoy the content on this blog, please share the URL with others!