How To Turn GitHub Into A To-Do List

How To Turn GitHub Into A To-Do List

I’m a huge fan of to-do lists. They help me stay organised, prioritise my day, and add structure to an otherwise chaotic schedule. I recently discovered what appears to be the best yet simplest way to keep a to-do list: a GitHub Gist.

This post originally appeared on Carl Sednaoui’s blog.

Allow me to elaborate: GitHub has this thing called “GitHub Flavored Markdown” which allows you to write task lists. Go to gist.github.com, create a new Markdown file (ending your filename with .md will auto-set it to Markdown). Enter some Markdown and create a Secret Gist (secret ’cause you don’t want others peeking on your to-dos).

How To Turn GitHub Into A To-Do List

Notice how the above example includes task lists which, when saved, transforms into checkboxes. The notation is:

  • – [ ] for an empty checkbox
  • – [x] for a checked checkbox
  • Note: You need a space between the dash and open bracket and, for unchecked items, a space between the open and closing brackets.

It’s like magic, but real.

How To Turn GitHub Into A To-Do List

Whenever you complete a task simply check it off (all changes are automatically saved):

How To Turn GitHub Into A To-Do List

At the end of my workday I click “Edit” to delete all tasks completed and move tomorrow’s tasks up:

How To Turn GitHub Into A To-Do List
How To Turn GitHub Into A To-Do List

Save the file (shortcut: cmd + enter) and voila!

How To Turn GitHub Into A To-Do List

Wait, but what if I want to know when I completed something? Easy, this is GitHub! Simply go to the revisions tab — your entire file change history is available there:

How To Turn GitHub Into A To-Do List

Find the sample to-do list here.

The Best To-Do List: A Private GitHub Gist [Carl Sednaoui]

Carl Sednaoui is a marketing engineer at @thinkful, co-founder of @CoderDojoNYC, and a @hackerschool alumn. You can find him hacking on http://www.mailcharts.com.


The Cheapest NBN 50 Plans

Here are the cheapest plans available for Australia’s most popular NBN speed tier.

At Lifehacker, we independently select and write about stuff we love and think you'll like too. We have affiliate and advertising partnerships, which means we may collect a share of sales or other compensation from the links on this page. BTW – prices are accurate and items in stock at the time of posting.

Comments