It wasn’t earlier than I switched to Obsidian as my note-taking app that I started utilizing Markdown. I might heard of it earlier than as a result of certainly one of my favourite hacktivists, Aaron Swartz, considerably contributed to its creation in 2004. However Markdown gained important mainstream adoption after GitHub launched in 2008 and used it for README information. Likelihood is you have already used it with out realizing it . Nevertheless, it is grow to be much more necessary now, because of the proliferation of LLMs and AI brokers.

Whereas utilizing much less tokens

There has all the time been a transparent differentiation between machine-readable content material and human-readable content material. Take HTML as an illustration: studying uncooked HTML code is unintuitive, however a browser reads it and renders a lovely web site for me to see. There’s an enormous disconnect between what I see and what the browser renders. The distinction is much less noticeable in Markdown as a result of the precise content material is not buried between sophisticated tags, brackets, and related ancillary stuff. The syntax is minimal and makes use of easy characters: even in the event you see Markdown information in a plain textual content reader, you’ll perceive it. A Markdown reader will make it look fairly; that is about it.

Most of us immediate LLMs in a conversational tone, writing down paragraph after paragraph, fully disregarding any construction. Now, that is okay for easy on a regular basis duties. However if you’d like your LLM to present you higher output, use Markdown. An unstructured wall of textual content makes the LLM work tougher to grasp the duty, and the supplied context. However in the event you use Markdown, it is a win-win state of affairs: you find yourself utilizing fewer tokens whereas getting higher outputs within the course of. The outcomes are much more noticeable while you’re vibe coding simple apps: including a blob of textual content will get you very completely different outcomes than attaching a structured Markdown doc that has the stack, options, design, and do-nots listed individually.


Obsidian and Microsoft Word apps open on a BENQ monitor


I stopped using Microsoft Word and write everything in Markdown now — this is my setup

Why Markdown changed Phrase in my writing workflow.

Markdown is much more essential when utilizing AI brokers which are executing a set of duties, accessing completely different apps, and cross-checking. The directions that govern AI brokers’ habits are sometimes written in plain Markdown information. GitHub Copilot reads a copilot-instructions.md file sitting in your repository, whereas Claude and ChatGPT’s custom instructions area helps and responds to Markdown. Figuring out Markdown will allow you to learn, audit, and customise your AI device’s habits to make it work the best way you need it to.

Markdown is all over the place

You may add higher formatting in instruments you utilize daily

Markdown syntax in a web browser

Reddit, Obsidian, Notion, Discord, WhatsApp, Slack, and innumerable different instruments help Markdown. All of them could not help the total gamut of Markdown parts, however they help simplified variations of Markdown. Possibly you have used _word_ and *phrase* to italicize and daring particular phrases on WhatsApp already. Or possibly you start unordered lists in your Slack messages by utilizing a hyphen (-). Sure, that is Markdown too.


Laptop showing a slideshow made with Markdown in Obsidian


I use Markdown instead of PowerPoint to make slideshows and it’s fantastic

Markdown slides really feel like dishonest in one of the simplest ways.

I started utilizing Markdown by familiarizing myself with its six most typical parts from its syntax, and I have not really felt the necessity to go deeper:

  1. Headings: # Heading, ## Heading, ### Heading, for H1, H2, and H3 respectively.
  2. Daring: **phrase**
  3. Italics: *phrase*
  4. Bullet checklist: - merchandise
  5. Hyperlink: [text](URL)
  6. Blockquote: > textual content

You may additional familiarize your self with the Markdown syntax utilizing this cheat sheet on Markdown Guide.

Coming again to Obsidian for a bit. One huge purpose for its vast enchantment is that your notes are accessible endlessly, even when Obsidian disappears tomorrow. You could have Markdown to thank for this: Obsidian notes are saved as Markdown information (change to Supply View to see the syntax), and Markdown itself is a free and open-specification language. You may open .md information in Notepad, Phrase, TextEdit, or virtually any textual content editor on any system; it’ll nonetheless be legible. Not like apps that use closed supply formatting, Obsidian, as a result of it makes use of Markdown, can guarantee your notes stay moveable and safe endlessly.

2023_Obsidian_logo

OS

Home windows, macOS, Linux, Android, iOS, iPadOS

Developer

Dynalist Inc.

Pricing mannequin

Free

Preliminary launch

March 30, 2020

Obsidian is a local-first, Markdown-based note-taking software that shops your notes as plain textual content information and allows you to construct interlinked “vaults” of data. It helps plug-ins, graph visualisations, and full management of your information reasonably than locking you right into a proprietary format.


Markdown is straightforward to be taught

If I am being trustworthy, it will take you about 20 minutes of deliberate effort to get a grip on Markdown’s fundamentals. Because it was designed as shorthand for primary HTML markup, it is minimal, and the six essential parts I listed above are a stable place to begin. However you’ll be able to go deeper and discover ways to add photos to Markdown docs, assign variables to the principle parts of Markdown and extra. Possibly attempt prompting your favourite AI device completely in Markdown, after which discover the remainder of its capabilities.


Source link