selfcontained[web development]

Articles tagged with "markdown" (2)

markdown powered blogs

Saturday April 14, 2012
By Brad Harris

Switching from a complex blogging platform to a lightweight, file-based blog is something of a trend amongst web developers lately. I chalk it up to our love of simple solutions, and a preference of interfacing directly with a file-system. I much prefer to open up SublimeText2, go into distraction free mode and create a markdown file for a new article. For me it's a smaller barrier of entry to writing than logging into Worpress and gathering my thoughts in a <textarea>.

what's out there

There are some great options out there for markdown based blogs. My preference is towards node.js, and Wheat (created by Tim Caswell) as a platform for is one of the more popular solutions in that category. Blacksmith is another great solution, created by nodejitsu. Both are interesting and powerful solutions, but weren't exactly what I wanted.

javascript is easy

I wanna be in control of the urls for articles, use the templating engine I prefer, and have some fun writing javascript. I also want to be able to start my blog up locally on a node http server to tweak it and test it, and not have to generate the static site to view every change. For the live site, I want to just clone a git repo on a server, and run > node generate.js to create a static site for Apache to serve. So I did, it was fun. Feel free to check it out, maybe fork it and see what you think.

i can haz dropbox blog?

Check out what Joe Hewitt is doing to integrate Dropbox into his blogging solution. I dig it.

Friday July 8, 2011
By Brad Harris

Markdown is a great shorthand syntax for creating HTML, and subsequently, for taking notes. I often take notes for different situations and use the Markdown syntax to help give them structure and organization. One thing I found I often wanted was a way to enter that Markdown somewhere, and have it generate an HTML page from it, with a permalink so I could share it or access it later. The Markdown dingus provides a great UI for testing out HTML conversion, but doesn't provide any persistence, so I threw together a pretty quick site that fit my needs.

It's pretty basic, but you can throw in your Markdown and you end up with a unique url you can share with the generated HTML. I was too lazy to add a full-blown account registration layer to organize and manage your documents, but did add Facebook login so you can do that if desired. Perhaps I'll add other forms of login if anyone else ends up using it. Anything you put on there is public as well, for now. Here's the permalink to some notes I took at this year's Velocity Conference.