Markdown 101 · Part 1/10
Markdown is a lightweight markup language that uses plain-text symbols—such as # for headings and - for lists—to format documents cleanly. You only need a .md file and any text editor (Notepad, VS Code, or Obsidian) to get started, with zero proprietary software or complex menus.
Why Write in Markdown?
Because Markdown files are pure plain text, they remain readable on every operating system for decades. Without distracting font and layout toolbars, you can focus on structuring your ideas clearly.
Tools like Obsidian, GitHub, Notion, and static site generators such as Hugo all read .md files natively.
Create Your First Markdown File
Open your text editor, create a file named first-note.md, and save it with UTF-8 encoding:
# A Quiet Morning Without Distractions
Today I spent 25 minutes writing before opening social media.
## Today's Tasks
- Mute notifications.
- Open a blank file.
- Write one clear idea.
Here, # creates the main heading, ## creates a subheading, a blank line separates paragraphs, and - starts each bullet item.
Essential Syntax Cheat Sheet
| Purpose | Markdown Syntax | Rendered Output |
|---|---|---|
| Section heading | ## Heading | Level-2 heading |
| Bold text | **bold** | bold |
| Italic text | *italic* | italic |
| Bullet list | - Item one | Bulleted item |
| Inline code | `command` | command |
| Link | [label](https://...) | Clickable link |
Common Beginner Pitfalls
- Accidentally saving as
.md.txt: On Windows, Notepad may append.txtautomatically. Choose Save as type: All Files so the extension stays.md. - Encoding issues: Always save as UTF-8 (not ANSI) so accented characters and symbols display properly.
- Missing space after
#or-:#Headingis treated as plain text; always add a space (# Heading).
Practice Now
Create a .md file with one heading, two short paragraphs, and a three-item list, then preview it in your editor.
Practice Now
Change the heading to what you want to write today. Add one paragraph and a three-item list.
Show hint
Use # followed by a space for the heading. Separate paragraphs with a blank line; start each item with - and a space.
Runs locally in your browser (nothing is uploaded or auto-saved). Supports headings, paragraphs, lists, checklists, tables, blockquotes, code, emphasis, links, and local site images.
Source: CommonMark Help.
In the Markdown 101 series:
- Part 01: What Is Markdown and How to Create Your First .md File (reading)
- Part 02: How to Write Headings, Paragraphs, and Emphasis in Markdown
- Part 03: How to Write Lists, Blockquotes, and Code Blocks in Markdown
- Part 04: How to Add Links and SEO-Friendly Images in Markdown
- Part 05: Minimal Markdown Post Template and YAML Front Matter for Blogs
- Part 06: How to Preview and Publish Markdown Posts to Hugo on GitHub Pages
- Part 07: How to Create Tables and Horizontal Rules in Markdown
- Part 08: How to Write Checklists, Footnotes, and Escaped Characters in Markdown
- Part 09: How to Use Obsidian Callouts and Wikilinks and Export Cleanly to Hugo
- Part 10: Capstone Practice - Write a Complete Markdown Article from Scratch
Loading comments...