What Is Markdown and How to Create Your First .md File (Markdown 101 - Part 01)

// SERIES: Markdown 101 (10 lessons · Jump to any part)
  1. 01 Capstone Practice - Write a Complete Markdown Article from Scratch (Markdown 101 - Part 10)
  2. 02 How to Add Links and SEO-Friendly Images in Markdown (Markdown 101 - Part 04)
  3. 03 How to Create Tables and Horizontal Rules in Markdown (Markdown 101 - Part 07)
  4. 04 How to Preview and Publish Markdown Posts to Hugo on GitHub Pages (Markdown 101 - Part 06)
  5. 05 How to Use Obsidian Callouts and Wikilinks and Export Cleanly to Hugo (Markdown 101 - Part 09)
  6. 06 How to Write Checklists, Footnotes, and Escaped Characters in Markdown (Markdown 101 - Part 08)
  7. 07 How to Write Headings, Paragraphs, and Emphasis in Markdown (Markdown 101 - Part 02)
  8. 08 How to Write Lists, Blockquotes, and Code Blocks in Markdown (Markdown 101 - Part 03)
  9. 09 Minimal Markdown Post Template and YAML Front Matter for Blogs (Markdown 101 - Part 05)
  10. 10 What Is Markdown and How to Create Your First .md File (Markdown 101 - Part 01)

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

PurposeMarkdown SyntaxRendered Output
Section heading## HeadingLevel-2 heading
Bold text**bold**bold
Italic text*italic*italic
Bullet list- Item oneBulleted item
Inline code`command`command
Link[label](https://...)Clickable link

Common Beginner Pitfalls

  • Accidentally saving as .md.txt: On Windows, Notepad may append .txt automatically. 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 -: #Heading is 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.

Live Preview
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:

Loading comments...