Markdown and Barry


The Tech Shelf

Where Westley talks about Markdown

Humans write a lot and most of it is done on computers these days. If someone asked you to write them a letter, where would you start? Most would open up Word or Google Docs. We all know the headaches that these word processors can cause: formatting not doing what you want it to, files getting lost, the person you are sending files to doesn’t use the same processor, et cetera.

What if there was an easier way to write basic documents to avoid all of that? Something that can be opened and read on any computer and easily shared? Something with simple and predictable formatting?

Meet Markdown.

Developed in 2004 by John Gruber and Aaron Swartz, Markdown allows you to write in plain text and doesn’t require a special program to read the content. Word documents (.doc or .docx) are binary files; ones and zeroes that machines can read very well but humans can’t read at all. Thus, we need the Word program to translate those ones and zeroes to plain text so that we can actually use them. “Languages” like Markdown and HTML allow us to work directly with plain text so that we don’t need a specific translator.

I put languages in quotes for a reason. Markdown is what is generally known as a lightweight markup language. Another markup language is HTML (Hyper Text Markup Language) which is what webpages are written in (including what you are reading right now!). At a general level, markup languages simply describe the content in a digital document. Lightweight markup languages (like Markdown) are designed to be simple, easy to use, and human-readable.

All of the posts of this newsletter are written with Markdown. You can see the raw Markdown of this exact post on our GitHub repo, and anyone with internet can read it. What you are reading now is the conversion of that Markdown into rendered content. In the raw Markdown, you can see that the section headings are defined by octothorpes (or hashtags for the youngsters) like this:

## Popcorn and A Coke
### *Where Jacob talks movies*

## The Tech Shelf
### *Where Westley talks about Markdown*

When the conversion between Markdown and what you are seeing now happens, the program knows when it sees an octothorpe to make the text that follows larger and grey.

Similar rules apply for links, bold font, italic font, and others:

[our GitHub repo.](



~~Strike through~~

- Bulleted
- List

1. Numbered
2. List

This all makes writing on the internet incredibly easy. No need to mess with styling or formatting, you can just simply write. So why isn’t everyone using Markdown? For the everyday lay-person it just isn’t as easy and for most tasks a Word document works great. There is no widely available and popular Markdown editor made specifically for the task. However, if you do a lot of communication on the internet, I would suggest learning Markdown and finding a good system that works for you. Personally, I use VSCode and that works great for the workflow of the newsletter.

There have been some (controversial) standardization efforts that attempt to unify the syntax and all the different implementations of Markdown. As a result, Markdown support is coming to more and more platforms like Discord, GitHub, Slack. I think Markdown’s simplicity and optimization for writing will make it increasingly relevant in the future.

I leave you this week with a joke and a Markdown example for you to try. Paste this into Discord and see the Markdown magic:

*I asked my friend "Do you know any other word for a big rock?"

He said "Boulder?"*

I said **"Do you know any other word for a big rock?"**

I have the honor to be Your Obedient Servant,


Popcorn and A Coke

Where Jacob talks movies

Well shit.

Ok, ok, don’t kill me, but I didn’t rewatch “The Sisters Brothers” like I said I was going to, BUT I did start rewatching “Barry” with Bill Hader! so… ok, I know that doesn’t help in any kind of way, but I was hoping it could distract you from my laziness.

Before we get into Barry, let me say that I am actually planning on rewatching The Sisters Brothers, but I didn’t find the motivation this week, so stay tuned on that one.


Bill Hader (Main)

I can not say enough good things about this show, it is beyond funny, a very well told and filmed story, and the whole premise of the story is incredibly unique. In this show, we follow a retired marine, and his internal battles following the experiences of war. Suffering from PTSD, Barry tries to deal with it on his own, he fails, but an old family friend steps in and offers him an opportunity to use the skills he learned in the military for a “good” purpose, killing bad guys.

So Barry becomes a hitman, turns out he is really good at it, but after a while, he starts to wonder if this is actually for a good purpose. During a hit, Barry finds himself getting pulled into an acting class in LA, while he is taking care of the “Job” he realizes perhaps acting is his true passion (That is hilarious, a hitman is like “I wanna be an actor!”).

That is the premise of the show and I hope all of you go start it because then you’ll understand my references, oh and “NoHo Hank” is my favorite character I have ever seen… Ever.

Anyway, love you all! and thank you for your time.


What We Like This Week