Writing Notes in Markdown: A Primer - Effective Remote Work

Understanding Markdown for Note-Taking

Introduction to Markdown

• Justin introduces the topic of writing notes in markdown, contrasting it with rich text formats used by applications like Evernote and Notion.

• He emphasizes that this video is suitable for both beginners and experienced users looking to refresh their knowledge on markdown.

What is Markdown?

• Markdown was created by John Gruber as a simple way to write for the web, allowing easy conversion to HTML without needing complex coding skills.

• The original purpose was to simplify blog writing before WYSIWYG editors became common, making it less tedious than hand-coding HTML.

• Various flavors of markdown exist (e.g., CommonMark, GitHub Flavored Markdown), each extending the capabilities of the original specification.

Key Concepts in Markdown

Headings

• Headings in markdown are created using pound symbols (#). For example:

• One pound symbol (#) for Heading 1

• Two pound symbols (##) for Heading 2

Text Formatting

• To bold text, use two asterisks (**) or underscores (__). For italics, one asterisk (*) or underscore (_) suffices.

• Underlining is not possible in markdown; underlines only appear when creating links.

Lists

• Ordered lists are made using numbers followed by a dot (1. Item), while unordered lists use dashes (- Item) or asterisks (* Item).

• Many note-taking applications automatically format these lists as you type, simplifying list creation.

Block Quotes

• Block quotes are created using the right angle bracket (>). Multiple lines can be combined into one block quote for clarity.

Linking

Understanding Markdown for Note-Taking

Introduction to Markdown Links

• Markdown allows for clean link formatting, where the text appears clickable and directs users to a specified URL without cluttering the document.

• Reference-style links can be used to keep documents tidy; instead of displaying long URLs, you can reference them at the bottom of your document.

• This method enhances readability by preventing large URLs from disrupting the flow of text.

Images in Markdown

• Images are inserted similarly to links but require an exclamation point at the beginning and use alt text instead of link text.

• Alt text provides context when hovering over images, enhancing accessibility and user experience.

• Reference links can also be applied to images, allowing for organized documentation with image URLs placed at the bottom.

Benefits of Using Markdown

• Markdown facilitates quick information capture, reducing friction in note-taking processes which is crucial for productivity.

• The simplicity of markdown means less time spent on formatting and more focus on content creation, making it easier to jot down thoughts quickly.

Readability and Plain Text Format

• Documents written in markdown remain readable as plain text; there’s minimal formatting that could obscure understanding.

• Basic markdown syntax (like bullet points or bold/italicized text using asterisks) keeps notes clear without overwhelming visual elements.

Standardization Across Applications

• Many note-taking applications now favor markdown due to its standardized format, which simplifies transitioning between different tools.

Data Portability in Note-Taking Applications

The Ease of Data Transfer

• Users can easily port data between different note-taking applications, such as exporting notes from Bear and importing them into Obsidian.

• Transitioning notes between proprietary systems like Notion or Rome can be challenging due to their unique formatting, making markdown a preferable standard for flexibility.

Utilizing Multiple Applications

• Some users leverage multiple note applications to access the same library of notes, allowing for diverse functionalities; for instance, using Zettler primarily while also viewing links in Obsidian's graph view.

Advantages of Markdown Standardization

• Having markdown as a foundational standard simplifies the process of moving notes across various applications and ensures readability in plain text formats.

• Markdown allows users to easily identify headings, quotes, and links within their notes. Additionally, tools like Pandoc facilitate conversion to other formats (e.g., PDF or HTML).

Conclusion and Call to Action