43 Folders

43 Folders feed subscription icon - Shiny!Time, Attention, and Creative Work. After 4 years and a lot of productivity pr0n, we’re shifting gears. Re-learn how to use 43 Folders. Then back to work. [»]

”What’s 43 Folders?”
43Folders.com is Merlin Mann’s website about finding the time and attention to do your best creative work.

Newbie working with plain text: best practices for formatting etc?

Hey all,

I’ve searched far and wide online and am really surprised not to find very much info on this (perhaps I’m using the wrong search terms!).

After reading Bit Literacy, I decided that I wanted to starting using plain text files more at work, especially for notes. Unfortunately, years of reading 43F has enhanced my fiddly nature, and I’m more focused on trying to format my notes “correctly,” or at least to have some sort of standard to stick to.

Does anyone have any best practices (or web resources) for working with text on a page? Currently, I find text files difficult to read (and line breaks confusing).

Any thoughts?


Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.
Merlin Mann's picture

KISS

Gee, thanks for the left-handed compliment. ;-)

But, seriously, I think you answered your own question here.

Whenever you look at planning stuff like this — and this goes for tagging, filing, or any other kind of organizational widgetizing — it’s worthwhile to ask yourself what any extra layer of organization buys you and when you’ll see that value. Examples.

If a given text file is just a flat dump of lines (grocery list, ideas for future blog entries), then you probably need zero organization. Just keep appending new lines.

If it’s still a flat dump, but chronology is important, same goes. Just append to the bottom and maybe add a date header to each section. I like Markdown, so mine might look like:

### 2008-01-22 05:45:04
* foo
* bar
* bat

But then if you really need lots of organization inside the document, again, I’d go with Markdown or something similar that has syntax highlighting and semantic hooks inside your text editor of choice. E.G. when I write stuff in Markdown and use HTML “<Hn>“s like the one above, Textmate adds all those to a drop down menu that makes jumping thru the document very easy.

Just don’t make this more complicated than it needs to be. Be crazy-consistent about how you name files (that’s huge), but I wouldn’t get too wound up about text formatting until patterns start to emerge from real-world usage. Then just go for consistency over fanciness.

stuff that might help:

dedalusjmmr's picture

Textmate

Please note that the website for Textmate is http://macromates.com/

textmate.com goes to an advertising site :(

rfquerin's picture

Lifehacker and todo.txt

Besides all the great stuff right here on 43F that Merlin mentions, there is a fair amount of good stuff on text files over at lifehacker.com. Personally I use Gina Trapani’s todo.txt (todotxt.com) system for task management. I’ve tried plenty of others but it’s the only one that has stuck for me.

pmenair's picture

text

Org mode in emacs is nice for plain-text todo lists, scheduling, etc.

One of the nice things that it does is it’s table-making ability - it gives you well-formatted, plain text “|” delimited tables, which you can easily import to Excel if you want. Or a database, for that matter.

This is a nice solution to the classic trade-off between human readability and machine readability for structured data in plain text. Take a look at an xml file. Readable? Not so much.

Not sure I understand what is confusing you about line breaks. Are you talking about the unix/mac/pc inconsistencies re what characters or sequences of characters indicate line breaks, or something else?

pmenair's picture

another thing...

More info about what you’re trying to do in plain text might help. I assume from the forum that you are trying to roll your own PIM, but more detail would help us come up with best practices recommendations.

gte910h's picture

I use them almost exclusively for my business purposes

For my timelogs I keep in my consulting business (http://www.rowdylabs.com), I have three vim macros:

which outputs:
1/22/2008 10:38:20 AM - START

which outputs:
1/22/2008 10:38:20 AM

and which outputs:
1/22/2008 10:38:20 AM - END

I then have a time tracking program (a quick python script you can email me at michael.langford@rowdylabs.com if you want it) that adds up all the time in a given text file. This allows me to bill clients accurately for hourly work, yet let them know I was doing things, and that I did take breaks off the clock and what they were. In those logs I often take notes on phone conversations as they’re happening as well.

I usually do a format like:

1/22/2008 10:38:20 AM - START
Flurbed the fliberty on the face

1/22/2008 10:44:30 AM
Having issues flurbing

But I intentionally keep it a little messy so I don’t spend a lot of time reformatting it. It’s like when I scribble all over the front page of my moleskine when I get it so I can use the thing rather than going “oooh pretty paper” and “that thought isn’t good enough for that pretty paper”

My web page is similarly generated from a template and plain text.

       --Michael
phrakture's picture

Mind posting your vim commands?

It’d be nice to take a look at the nitty-gritty, as this is similar to my approach, but I’ve been using :r!date, which is fugly

swaroop's picture

Put this in your vimrc

I use this:

" To insert timestamp, press F3.
nmap <F3> a<C-R>=strftime("%Y-%m-%d %a %I:%M %p")<CR><Esc>
imap <F3> <C-R>=strftime("%Y-%m-%d %a %I:%M %p")<CR>
dbtodd's picture

text plus

I used Text Edit (Tiger) for a long time, but do like to dress up the text also. Partly for functionality, partly because I have to look at it every day. I moved to using Bean (bean-osx.com) which adds more formatting tools on top of the Text Edit engine. You can tweak line spacing for example. Making a template is a good idea and very easy.

matt's picture

Plain-text markup

If you’re looking for a system that works well for both reading plain-text and as markup for conversion to something prettier, I recommend reStructured Text. It’s heavily used in the Python programming community — lots of tools that can be very easily installed on OSX/Windows/Linux exist — and there’s even a handy website called rst2a that’ll accept it and spit back a PDF or HTML file of your text, completely beautified. (rst2a also accepts style sheets, if you don’t like any of their defaults.)

 
EXPLORE 43Folders THE GOOD STUFF

An Oblique Strategy:
Not building a wall; making a brick


STAY IN THE LOOP:

Subscribe with Google Reader

Subscribe on Netvibes

Add to Technorati Favorites

Subscribe on Pageflakes

Add RSS feed

The Podcast Feed

Inbox Zero

The original 43 Folders series looking at the skills, tools, and attitude needed to empty your email inbox — and then keep it that way. Don’t miss the free video of Merlin’s Inbox Zero presentation.

Making Time

3-part series on attention management for artists and makers. Read Bad Correspondence, The Job You Think You Have, and One Clear Line.