Markdown isn’t so much a language as it is a writing method. Markdown greatly simplifies the formatting for rich text elements, such as bold and italics, and web-friendly doodads, such as links to the Internet, using plain text. The fancy-pants word for this is syntax. Put simply, Markdown makes it deceptively simple to write for the webIn essence, the open Web, while not free from governmental and commercial pressures, is about as free from such pressures as a major component of modern capitalist society can be…. More and rich text word processors with plain text. It is a game changer, and by the end of this book, you are going to be a pro at it.Markdown
Our communication stack — WordPress, P2, and Element — speaks Markdown. Taking notes in Markdown allows you to paste them directly into the tools in our stack, complete with nice formatting.
There are many great Markdown editors. Ryan likes Ulysses, which is included in our Setapp for Teams subscription. See our Software page for more recommendations.
Why Markdown rocks:
There is no reason to make thought capture harder than it already is. In fact, the very best thought-capture routines are those that have the least friction between the thought and the act of writing it down. We even wrote the initial outline for this book in Markdown.
As we will show shortly, the Markdown syntax for standard outline elements, such as headings and bullets, is extremely simple to both write and read. Markdown is useful even for text that you never plan to publish on the web. It can be great for taking notes in meetings, conference calls, or in any situation where you need to get text down quickly. The simplicity of the syntax has another benefit—you can use whatever tool is handy: computer, tablet, or phone.Markdown
To answer this question, we designed a study in which we would interview several of these influential Markdown “teachers.” We mapped the Markdown affinity space, prioritizing those who had a significant audience that spanned multiple platforms, including blogs, podcasts, books, and Twitter feeds. In particular, we were interested in writers within the Markdown affinity space who published texts written in Markdown, taught users how to use Markdown, and made recommendations about Markdown-focused software.
When we started to analyze our data, however, we realized that this wasn’t a project about Markdown. Instead, we saw that the interviews offered insights about broader writing practices and software preferences. These writers were interested in and talked in detail about software-mediated approaches to writing practices—what they called “workflows.” We began to identify and trace a practice that we saw as “workflow thinkingWorkflow thinking is the act of reading knowledge work as modular and intertwined with technologies. Through workflow thinking, writers break any particular task into a series of smaller steps and… More,” which we introduce in this book. To build and contextualize our macro concept of workflow thinking, we offer the cases of three writers.Writing Workflows | Introduction
Formatting text in Markdown has a very gentle learning curve. It doesn’t do anything fancy like change the font size, color, or type. All you have control over is the display of the text-stuff like making things bold, creating headers, and organizing lists• Progress in human understanding has become increasingly complex and overwhelming.• Checklists help prevent serious but easily avoidable mistakes.• Checklists should be as short as possible, include all essential steps… More.
If you have ten minutes, you can learn Markdown!Markdown Tutorial | Lesson 1
Plain text doesn’t change. Fifty years from now, you’ll still be able to open a plain text file. Until we all have squiggly tentacles on our faces and communicate telepathically, plain text will be a thing.
What about conversion software? Let’s say a tiny black hole swallows up every Markdown converter on the planet. You still have nice, clean plain text.
You control your destiny because, yes, you guessed it: It’s plain text.Why I Use Markdown, & You Should Too – Portent
Since its introduction in 2004, Markdown has enjoyed remarkable success. Markdown works for users for three key reasons. First, the markup instructions (in text) look similar to the markup that they represent; therefore, the cognitive burden to learn the syntax is low. Second, the primary arbiter of the syntax’s success is running code. The tool that converts the Markdown to a presentable format, and not a series of formal pronouncements by a standards body, is the basis for whether syntactic elements matter. Third, Markdown has become something of an Internet meme, in that Markdown gets received, reinterpreted, and reworked as additional communitiesWhat I have always been hoping to accomplish is the creation of community.Community is magic. Community is power. Community is resistance.Disability Visibility: First-Person Stories from the Twenty-First Century https://www.amazon.com/Disability-Visibility-First-Person-Stories-Twenty-First-ebook/dp/B082ZQBL98/ https://www.amazon.com/Disability-Visibility-Adapted-Young-Adults-ebook/dp/B08VFT4R9T/… More encounter it. There are communities that are using Markdown for scholarly writing, for screenplays, and even for mathematical formulae. Clearly, a screenwriter has no use for specialized Markdown syntax for mathematicians; likewise, mathematicians do not need to identify characters or props in common ways. The overall gist is that all of these communities can take the common elements of Markdown (which are rooted in the common elements of HTML circa 2004) and build on them in ways that best fit their needs.”RFC 7764 – Guidance on Markdown: Design Philosophies, Stability Strategies, and Select Registrations
Further readingThere are three types of reading: eye reading, ear reading, and finger reading.The Dyslexia Empowerment Plan: A Blueprint for Renewing Your Child’s Confidence and Love of Learning Most schools and… More,