• If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • You already know Dokkio is an AI-powered assistant to organize & manage your digital files & messages. Very soon, Dokkio will support Outlook as well as One Drive. Check it out today!


Zen Habits style guide

Page history last edited by prolanguage 10 years, 5 months ago

I'm creating this style guide to help Zen Habits guest writers -- actually to save me time in editing, because there are certain style changes that I have to do repeatedly and I'd rather avoid that if possible.


If your guest post doesn't conform to this style guide, I may refer you to this guide and ask you to revise. It's possible that I might not publish your guest post if you can't get it to conform to this guide. I hope you'll understand!


HTML Code. Too often I need to clean up the html of guest writers who write a post in MS Word and then copy and paste it into Wordpress. MS Word creates horrible html -- it creates custom formatting for each paragraph, which means I need to go in and strip the formatting out of each paragraph. Very time consuming. If you write in MS Word, don't put any formatting or links into the post, and just copy the text into the HTML tab in the Wordpress post editor. If you don't know how to do this, then I suggest writing the post in a plain text editor that doesn't have formatting, or writing it within Wordpress itself. You know you've done it incorrectly if you look at the HTML tab in the Wordpress editor and find <p> tags before and after each paragraph, usually with some kind of font indicated within the tag. You've done it right if paragraphs show up just as plain text within the HTML editor.


Introduction. Some guest writers just launch into a list of tips. I prefer a post have an introduction of perhaps 4-7 paragraphs, because the reader needs to be sold on why he needs to read the tips. Why should he care about your tips on cutting back on Internet reading? The first couple paragraphs should grab the reader, and the introduction in general should explain the problem and why the reader should be interested.


Length. I don't have a guideline for number of words, but use my posts on ZH to guide you. Too short, and you might not be very useful (although there are exceptions). Too long and no one will read you. Make the post as long as the topic needs, no more or less.


Credits. Each post must begin and end with credits, and I'm particular about how this is done. Here's the first credit, at the very beginning of the post:


<h6><strong>Editor's note</strong>: This is a guest post from Joe Blow of <a href="http://joeblow.com">Joe's Guide to Blow</a>.</h6>


You should change it to reflect your name, url and blog title, of course. The final credit comes at the end of the post:


<strong>Read more from Joe at his blog, <a href="http://joeblow.com">Joe's Guide to Blow</a>, or <a href="http://joeblow.com/feed/">subscribe to his feed</a>.</strong>


Instead of your RSS feed link, you could put a link to your ebook or whatever you'd like to promote. Keep promotion to this paragraph, and don't overdo it or I'll cut it down.


Single space after periods. Academic papers require two spaces after periods (or other sentence-ending punctuation). Journalism style requires only one. I follow the latter.


Elipses. Space before and after, and three successive periods: "I think I'll wait ... for a second only."


Spelling. Please spell-check and read over your text, even if I don't follow this advice myself. Wordpress has a spell-checker and will underline misspelled words.

Übersetzung Deutsch Englisch

Übersetzung Englisch Deutsch

Übersetzung Deutsch Niederländisch

Übersetzung Englisch Deutsch

Übersetzung Englisch Deutsch



Übersetzung Französisch Deutsch


Übersetzung Deutsch Englisch

Übersetzung Deutsch Niederländisch



Übersetzung Französisch Deutsch


Übersetzung Englisch Deutsch


Übersetzung Englisch Deutsch

Lists. I'm particular about list formatting, only because I like consistency. If I can't have it in my opinions, at least my lists will be consistent. Here's the format:



<li><strong>Work smart<strong>. Not harder.</li>

<li><strong>Be smart<strong>. You dummy.</li>

<li><strong>Live smart<strong>. Not sure what this means.</li>



Of course, you could use <ol> for a numbered list. Note that the <strong> tag encloses the title of each list item, but not the period. Then there's a single space after the period, and the rest of the list item. There's a period at the end of the list item. You could also do it without the <ul> or <ol> tag, and have  which I do often (note that the numbers are inside of the <strong> tag):


<strong>1. Work smart<strong>. Not harder.</li>


This is what my grandpappy taught me.


<strong>2. Be smart<strong>. You dummy.


Not that you're a dummy, of course, but your mamma is.


<strong>3. Live smart<strong>. Not sure what this means.</li>


But it's good to have at least three list items, because what's a two-item list anyway?


ALL CAPS. Don't do it. Using all capital letters to emphasize words or phrases is, in effect, screaming at the reader. I prefer not to have posts on ZH scream at the reader -- it's not the tone I'm trying to establish. If you must, use italics to emphasize (the <em> tag) ... but don't do it too much (see next item). All caps should be used for acronyms only ... and acronyms should be avoided as much as possible, as no one likes to read a post with a bunch of acronyms. If you use an acronym, spell it out on first reference: "I'm not sure where I stand on the tactics of People for the Ethical Treatment of Animals (PETA)."


Excessive bolds and italics. Don't do it. I prefer to use bold to highlight the "subheadings" for sections within a post, or to highlight the first part of a list item (see Lists, above). I've used italics, but sparingly. Emphasis is best done by choice of words and sentence structure and length, not by formatting. Excessive use of bold or italics puts a strain on the reader.


Exclamation marks. Use them very, very sparingly. They should only be used to express extreme joy, excitement, anger, or the like. Not as part of regular speech. And never never use multiple exclamation marks. Or question marks combined with exclamation marks.


Tabs and spaces and tables. Don't use tabs in your text. Don't use a bunch of spaces to line text up exactly how you'd like. I generally avoid using html tables as well. Just write plain text and lists and avoid excessive formatting.


Images. I generally will choose the image to go with the post, but if you'd like to suggest one, that's useful. I use Flickr creative commons photos or ones I find on istockphoto.com, so you could just include a note with the url of an image you find in either of these. Generally I prefer vertical photos because of the format of my blog, but I violate that all the time if the best photo is horizontal. Go for close-up images with a person in it, cropped fairly close (they shouldn't be a small part of the photo, in the distance), preferably showing their face. High-quality images that look professional are a must. The person must be interesting somehow, visually.


Categories and tags. Choose one category in Wordpress, not three or five. No tags please, as I don't use them on ZH.


Excessive plugging and advertising. Posts are not published on ZH to promote you, your blog, your ebook, or your product. They're published to help readers. You may plug your blog or ebook or other product in the credit at the end of the post (see Credits, above), but not within the post. A post with excessive plugging or that reads like an ad for something will not be published.


Linking to your own posts. Acceptable once or twice within the post, if it's appropriate and useful to the reader, but generally to be avoided. Too many and the post won't be published.


Affiliate links. Please don't include them. I might turn Amazon links into my own Amazon affiliate links, but otherwise don't want any affiliate links.


Sponsored posts. I don't allow anyone to pay me for posts or to sponsor posts. I don't allow advertisers to post or influence my posts. If you do any of this on ZH, you'll be blacklisted by me and I will send venomous vibes your way. If I catch it before it's published, the post won't be published. Readers need to trust that posts are genuine, and aren't just ads.


Most important. Be extremely useful, and solve one of the reader's problems. This isn't a style point, but I had to include it because if you don't do this, you won't be published on ZH.


Note: I reserve the right to add to, subtract from, or otherwise revise this style guide at my slightest whim. I'm like that sometimes.


Also: I reserve the right to have typos and grammatical mistakes in this guide, if only to allow people to howl at the irony. Also because I'm not perfect.


from english to spanish


free translation english to spanish

custom essay writing services

Barbie dress up

Pacquiao vs Marquez 3

Pacquiao vs Marquez 3

Watch Pacquiao vs Marquez

Comments (7)

Annabel Candy said

at 4:38 pm on Aug 10, 2009

Well, I haven't got any excuses for sloppy presentation now. Impressed by your thorough approach and look forward to sending you my suggested post soon.

cafegurl said

at 6:01 am on Aug 11, 2009

Wow, i'm impressed!

Suzannah Windsor Freeman said

at 11:07 am on Aug 11, 2009

Thanks for this guide. It's always nice to be given directions ahead of time to avoid making extra work for either party.

Chris Lopez said

at 5:38 am on Aug 12, 2009

Hi Leo,

Great guide. I submitted my guest post last week. Would you like me to go back and re-format it to make your life easier?

Thanks, Chris

cafegurl said

at 11:13 pm on Sep 20, 2009

Love this style guide! I can't wait to use it.

jean compton said

at 3:04 am on Oct 13, 2012

Hey Leo. My name is Jean Compton and my post is called, "The Quiet Advantage".
I can be found at http://jeancompton.com/

directbobby said

at 3:21 pm on Nov 20, 2013

Your blog has some of the most fascinating information! I've read several pages here and I just had to comment and let you know that I thought you've been doing a great job here. Keep it up! http://jualacemaxsmanggis.blogspot.com , http://pupukhantujimmy.blogspot.com , http://jualeigeradventure.blogspot.com may be usefull

You don't have permission to comment on this page.