Hiltmon

On walkabout in life and technology

Letterhead - Markdown Style

So I get this request yesterday to send a document on letterhead. You all may remember letterheads from back in the day when companies had professional printers print their fancy logos on fancy paper that you then ran through the “good” laser printer that then went into matching fancy envelopes and someone stuck stamps on and mailed them.

I thought that letterheads went the way of the dodo about the same time fax machines and US Mail both died out. I was wrong. It turns out, sometimes to make something “official” (whatever the heck that means) you need it on letterhead. And since it’s 2013, a PDF version is acceptable.

Now I could have just dragged a logo into a Pages document, added the letterhead text, written the document, manually formatted it, PDF’d it and emailed it. But since I am probably going to do more of these, I decided to integrate letterheads into my regular Markdown process.

For this to work, I needed a markdown file for the document, a logo image and a stylesheet. I already have a logo and a CSS stylesheet for rendering Markdown in Marked, which I use to generate business documentation from Markdown source in my preferred business style for all my client engagements. Look and feel, covered.

So the only difference between a letterhead version of a document and a regular document is the logo, a silly header and a silly footer.

No problem, I created these with Markdown using a smidgen of HTML code and plonked them at the top and bottom of my document. I then saved them as TextExpander snippets for when I need them again.

Preview in Marked. Print to PDF. Sent. Easy as Pie.

The letterhead document source in Markdown looks like this. Note that it contains my standard Markdown Metadata headers as well.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
Title:          Sample Letterhead Document
Subtitle:
Project:        hiltmon.com
Author:         Hilton Lipschitz
Affiliation:    Noverse LLC
Web:            http://www.noverse.com
Date:           May 22, 2013

![](noverse-logo-160-40.png)
**Noverse LLC**  <span class="light">A New York Company</span>

# Sample Letterhead Document
22 May 2013

**Client Company Name**
Client Street Address
New York NY 10019

## RE: You need a letterhead?

Yadda yadda yadda.

More yadda yadda yadda.

<br/>
<br/>
<br/>
<br/>

**Hilton Lipschitz**
Noverse LLC
<span class="light"> **&middot;** +1 (917) 555-1234 **&middot;** www.noverse.com **&middot;** contact@noverse.com **&middot;** @noversellc</span>
<span class="light">--- My Office Street, City, State, Zip ---</span>

Notes on the markdown source:

  • There are two spaces after each line in the address and in the name block at the bottom. That way Markdown places them on different lines without creating paragraph gaps.
  • The <br/> lines are needed to create space for a signature which you used to use an instrument called a pen to scrawl your name in that space. For PDF letterheads, you can upload a signature image. But in this case, the recipient did not need the signature. “Official” but unsigned was weirdly fine too.
  • I like putting a subject at the top of things, such as in this case Sample Letterhead Document. In the 19th century, you used to put the title where the RE: You need a letterhead? is.

And the result, an “official” looking document while remaining in the Markdown Mindset. Sweet!

Follow the author as @hiltmon on Twitter and @hiltmon on App.Net. Mute #xpost on one.

Comments