Markdown Reference Guide for Obsidian#

1. View Modes (Why you can’t see the code)#

Obsidian has two main ways of displaying notes. If you see the “formatted” version (like a clickable checkbox), you are in Live Preview.

  • Toggle Code View: Press Cmd + E to switch between Editing and Reading modes.
  • Source Mode: To see the “raw” characters (like - [ ]) all the time, go to the status bar at the bottom right and select Source Mode.
  • Temporary Reveal: If you click directly on a formatted item (like a checkbox), Obsidian will temporarily reveal the code for just that line.

1. Headers#

Use # followed by a space. The number of # symbols indicates the header level.

H1 Header#

H2 Header#

H3 Header#

H4 Header#


2. Text Formatting#

Standard styling for emphasis and strike-through.

  • Bold: **Bold Text**
  • Italic: *Italic Text*
  • Bold & Italic: ***Bold & Italic***
  • Strikethrough: ~~Strikethrough~~
  • ==Highlighting==: ==Highlighted Text== (Obsidian specific)

3. Lists#

Both ordered and unordered lists.

Unordered List:

  • Item 1
  • Item 2
    • Sub-item 2.1
  • Item 3

Ordered List:

  1. First Item
  2. Second Item
  3. Third Item

Task List:

  • Unfinished Task
  • Completed Task

4. Code Blocks#

Use triple backticks for blocks and single backticks for inline code.

Inline Code: Use `command` to show sudo apt update inline.

Code Block with Syntax Highlighting:

# This is a bash code block
sudo apt update && sudo apt upgrade -y
pveperf /etc/pve

Warning#

> [!WARNING]
> **Warning:** You need to close the terminal session and reopen a new one for the alias to take effect