How I write
My work consists almost entirely of two activities:
I do a few other things too, but it’s mostly those two things. And I spend the vast majority of my time doing #2.
And given my penchant for efficiency in all things, I’ve been refining—and, on occasion, wholly reinventing—my writing workflow for some time now.
Which brings me to today.
Lots of folks—myself included, definitely—love seeing the guts of how other people work. So, in what may be my greatest act of self-indulgence ever, I figured I’d describe how, exactly, I write. Plus, sometimes people ask me about this.
The things I write fall into five basic categories:
- Shorter articles: blog posts, newsletter articles, and so forth
- Books or other long-form pieces
- Promotional materials like emails and sales copy
- Outlines and other planning-like stuff for all of the above
- Miscellany including social media updates, emails, and other odds and ends
Let’s chat about these in reverse order, just to mix things up.
Social media updates and other such jibber-jabber
Normally, I compose social media updates and whatnot in their respective “compose windows:” using the Facebook app or site, using Tweetbot, etc. If I’ve got a pretty good joke idea brewing, I’ll sometimes begin in my beloved Drafts so I can easily rework it and publish it whenever it’s ready.
My email client of choice on OS X is MailMate. It supports native Markdown composing as well as external editing, so I can write emails using my favorite text editor (MacVim, which we’ll talk about in a minute). Incidentally, it also searches my chunky mail archive—roughy 82,000 messages as I type this—without breaking a sweat. It’s a great app; check it out if you haven’t already.
Outlines normally begin their lives in Evernote. The typical outlining process looks like this:
- Dump my brain into a new Evernote note.
- Try to find a cohesive story or narrative that gives each item a sense of order.
- Rearrange things into a rough, crude topical outline that will almost certainly be revised, scrapped, rewritten, scrapped again, and ultimately found worthy of actual work or tossed in the round file.
(Relevant bit of history: here’s the original brain dump outline thingie for what would eventually become Evernote Essentials. I created this document on January 14, 2010; it was going to be a series of blog posts rather than a book and my original working title was “Evernote Black Belt.” Funny to go back and read it now, but it’s a good example of what I’m describing.)
By the end of the outlining process, I have a nicely-formatted list of everything I need to write. In the case of books with multiple chapters or promotions composed of several different written pieces, each discrete part has a checkbox next to it that—shocker—I mark when the indicated step is complete.
It’s also not uncommon for me to print out paper copies of my outlines so I can keep my text editor in full screen and not have to switch back and forth between it and my outline.
Marketing and promotional stuff
Ugh, I hate marketing and promotional stuff
I know, I know. But as a guy who runs his own little circus, it’s rather important that I try to convince people to buy what I’m selling because, as it happens, my kids like to eat.
Everything I write for the purposes of advertising or selling my wares starts out as Markdown text. In most cases, it spends most of its life that way until it’s time for publication.
Content that fits in to this category will always end up as HTML either in WordPress or Ontraport (the fancy pants sales/CRM/marketing software I use and, incidentally, love).
For writing in Markdown, I use three tools almost exclusively. Well, four actually:
- nvAlt on my Mac for document organization and search.
- MacVim for the actual writing (using the fancy Note > Edit with menu option in nvAlt), and Marked for previewing the end result.
- Editorial on my iPad and, to a far lesser extent, iPhone.
- Dropbox for storage, instantaneous sync, and versioned backup. nvAlt and Editorial both support using Dropbox for storage and it’s awesome.
(Spoiler: these are the same tools I use for writing just about everything, but we’ll get further into that in a minute).
nvAlt’s headline feature is that I can seach hundreds of Markdown text files as quickly as I can type. No joke, it’s lightning fast. I use a naming scheme inspired by something Merlin described during one of his many appearances on the venerable Mac Power Users podcast (blog posts have ‘bkx’ in the filename, documents related to products include my own shorthand for each product, and so on), so quickly whittling down my massive list of Markdown files to the handful I want takes a couple of seconds.
Quick aside regarding my choice of text editor
Why, when surrounded by a wealth of gorgeous, Markdown-aware text editors on the Mac, do you suffer with that dinosaur?
Short answer: I can type circles around anybody using Byword, Ulysses, or any of their ilk. I’ve been using Vim for over a decade (first as a programming tool, now as a composition tool) and I know it well. Vim won’t win any beauty contests, certainly, but I’m more than willing to sacrifice beauty in favor of unparalleled capability.
I won’t belabor this point further here, but if you want to know more about this, leave a comment below and I’ll write about it another time.
Books and other really long projects
The writing process for both books looked like this:
- Brainstorming and outline in Evernote; in the case of the second book and as an experiment, the outline was eventually moved to OmniOutliner, which supports folding and a few other niceties.
- Composition looked a lot like it does for shorter works: Markdown text files in Dropbox.
- Editing, layout, sprucing up, and eventual publication all went down in my beloved Scrivener.
Scrivener lets me output my books in all of the different formats I need to sell them various places (like Amazon and the iBooks Store), as well as in PDF format. Even if you never use Scrivener to compose a single word of your book, the publishing features are worth ten times the price of admission, if you ask me.
And, of course, everything lived in Dropbox the whole way. Thanks to a Dropbox feature called Extended Version History—the salty veterans among you will recognize this as a descendent of now-retired “Packrat” feature—each time I save a document, a version is recorded. If I need to examine or revert to a version of a Scrivener file from months ago, Dropbox allows me to do that.
Shorter articles, blog posts, etc.
By now, it shouldn’t surprise you to learn that I write all of my blog and newsletter content in Markdown using the Dropbox-backed text editors I described before. Hell, I’m using them to write these words.
When I’m writing on my Mac, as I mentioned, Marked is running to show me a real-time preview of the resulting HTML.
(This might be a good time to tell you that I never, ever, ever compose anything longer than a couple of sentences in a web form. If you’re in the habit of writing your blog posts in the WordPress composition area, you’re asking for trouble. I don’t care how smart or capable a web app is — it’s still subject to browser weirdness and network failure and relying on it too much will bite you on the hindquarters sooner or later. I speak from experience. Moving on…)
Once I’m happy with the text, I open the Markdown file in Marked, and copy the HTML source code, then paste it wherever it needs to go (either in WordPress or Ontraport, both of which support authoring in raw HTML). If I need to add any images or other embedded media, I do so by hand.
Over the years, my processes and tools have gotten slimmer and fewer in number. I like simple systems with as few moving parts as possible. Writing this way satisfies my three main requirements:
- Write anywhere on whichever device I happen to have with me.
- Have my work synced off of said device instantly (either as I type or upon saving).
- Format portability; no matter what format the finished product must be, I can get there starting with Markdown.
The main takeaway here is the limited number of simple tools. At the bare minimum, I need a plain text editor and Dropbox to sync everything. I realize there are alternatives out there and I’m sure they’re swell, but Dropbox just works. And since I’m primarily dealing in teensy text files, syncing my stuff between my devices takes mere seconds, even over LTE.
Hope this has been informative. Hit me in the comments if I missed something obvious or if you have any questions.
- I didn’t intend for that to be a semi-crude joke, honestly. But that’s how it came out, so I’m leaving it that way. These things have to be fun, folks. ↩
- These rarely work, but trying to make the occasional Internet funny is something I enjoy. ↩
- Yes, I know about Time Machine. I used it for years and I’m aware it offers somewhat similar features, but I prefer Dropbox’s implementation of this feature. Label me as a heretic all you like. I’ll own it. ↩
- Check it out. ↩
(Photo courtesy of Ak~i)