# Markdown Notes & Programs

## What's Markdown?

[Wikipedia explains it like this](http://en.wikipedia.org/wiki/Markdown): "Markdown is a lightweight markup language, originally created by John Gruber and Aaron Swartz allowing people 'to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML)'. The language takes many cues from existing conventions for marking up plain text in email."

I'd explain it this way: it's a much quicker, easier way for me to create HTML than by typing out the HTML by hand, or even by using a WYSIWYG like Dreamweaver (it's also orders of magnitude cheaper than Dreamweaver as well!). I can also export my Markdown to other formats as well, like RTF, PDF, and text. The fact that a Markdown file is just a text file is a big bonus, as that means I can read & edit the file using standard tools (that also future-proofs my Markdown as well, since plain text files will be readable far into the future). Finally, it seems like a good thing to learn, as it's exploding in popularity, with great software tools appearing all the time & growing website support.

## Markdown Syntax

Learning Markdown is actually very easy. John Gruber & Aaron Swartz invented Markdown, but he purposely kept it fairly simple. Fletcher Penney extended it by adding more syntax & then called his additions MultiMarkdown. The editors mentioned later all support MultiMarkdown, so I'd start with the basics of Markdown and then move on to MultiMarkdown.

[Markdown Syntax](http://daringfireball.net/projects/markdown/syntax)

[Wikipedia on Markdown](http://en.wikipedia.org/wiki/Markdown)

[MultiMarkdown Syntax](https://github.com/fletcher/peg-multimarkdown/wiki/How-do-I-create-a-MultiMarkdown-document%3F)

## Markdown Editors

You can enter Markdown in any text editor & then generate HTML or other formatted files, but this requires a conversion tool of some sort that can be difficult or at least nerdy to use. Fortunately, there are now specific editors that let you write in Markdown and then automatically generate HTML (or more than that). Here are the best.

### Mac OS X

#### [Byword](http://www.bywordapp.com)  

$10 at the [Mac App Store](http://itunes.apple.com/us/app/byword/id420212497?mt=12)

Great features:

* Really nice Markdown editor
* Word & character count at bottom of window
* Preview mode
* Export HTML, PDF, RTF, Word, LaTeX
* Supports Mac OS X technologies & UI (Full screen, Versions, Autosave, & Resume)

#### [Mou](http://mouapp.com)

Free while in beta; commercial when 1.0 is released

Great features:

* Syntax highlighting
* Live preview
* Themes
* Incremental search with pattern matching
* Auto-complete text

### Windows

Your choices for Windows are a lot more limited, as it seems most Markdown editors are written for Mac OS X. But here's one that looks decent, although it's written in Adobe AIR. That makes it cross-platform, but it also means that it can't take advantage of specific Windows technologies.

#### [Gonzo](http://savagelook.com/blog/actionscript3/gonzo-an-open-source-markdown-editor)

Free

Great features:

* Live preview
* Tabs
* Integrated Markdown cheatsheet

### Online

I found one online Markdown editor that looks interesting, although it's basic.

#### [Jon Combe: Online Markdown Editor](http://joncom.be/experiments/markdown-editor/)

Free

Great features:

* OS-independent—you just need a web browser
* Nice, easy way to learn the basics of Markdown
* Flexible layout