NateCueWriting Markdown in Obsidian: A Complete Guide
Obsidian is a note-taking app built entirely on plain
.mdfiles. Every note you write is Markdown. Learning the syntax properly means faster writing, cleaner formatting, and a knowledge base that genuinely connects itself together.
How It Works
Obsidian reads and renders Markdown directly in the editor. You type plain text syntax, and Obsidian transforms it into a polished visual layout in Reading view - no mouse clicks through toolbar menus, no formatting panels.
Obsidian has two modes:
- Editing view - shows all raw Markdown syntax
- Reading view - shows the fully rendered result, like a web page
Toggle between them with Ctrl/Cmd + E.
Core Markdown Syntax
Headings
# H1 - Main title (usually the note name)
## H2 - Major section
### H3 - SubsectionObsidian uses headings to build the Outline panel on the right side. Use H2 and H3 to organize longer notes.
Bold, Italic, Strikethrough
**Bold**
*Italic*
~~Strikethrough~~
**Combined with _bold and italic_**Lists
- Bullet item
- Sub-item (press Tab to indent)
1. Numbered item
2. Second itemCheckboxes (To-Do Lists)
- [ ] Not done
- [x] DoneObsidian renders these as clickable checkboxes directly in the editor.
Code
Inline: `npm install`
Block:
```javascript
const greet = () => console.log("Hello")
```Links
[Display text](https://natecue.com)Obsidian-Specific Features
1. Wikilinks - Connecting Notes Together
This is Obsidian’s most powerful feature. Use [[note-name]] to create a link between two notes:
[[another-note-name]]
[[another-note|Custom display text]]
[[note-name#section-heading]]Type [[ and start searching - Obsidian auto-suggests notes from your vault.
Wikilinks build the Graph View - a visual map showing how all your notes connect to each other.
2. Frontmatter (YAML)
A YAML block at the top of any note stores metadata:
---
title: "Note Title"
date: 2026-04-14
tags: [markdown, obsidian, guide]
status: draft
---Use the Dataview plugin to query this metadata like a database - filter notes by tag, date, status, or any custom field.
3. Callout Blocks
Callouts highlight important information with visual labels:
> [!NOTE]
> A standard informational note.
> [!TIP]
> A useful tip or shortcut.
> [!WARNING]
> Something that needs attention.
> [!IMPORTANT]
> Critical information.Available types: NOTE, TIP, WARNING, IMPORTANT, QUESTION, QUOTE, ABSTRACT
4. Tags
#single-tag
#group/nested-tagTags can appear inline in text or in frontmatter. Use the Tags panel to filter your vault by tag.
5. Embedding Notes
![[note-name]]
![[note-name#section-heading]]Embed the full content of another note inline - particularly useful for MOC (Map of Content) notes that serve as hubs linking related content.
6. Embedding Images
![[image-name.png]]
![[image-name.png|300]] ← 300px wideDrag and drop images directly into the editor - Obsidian copies them into your vault and creates the link automatically.
Why Markdown in Obsidian Is Worth Learning Properly
Faster than Word: You never have to leave the keyboard. ## is faster than navigating Format > Heading. Over a day of writing, this adds up.
A real second brain: Wikilinks plus Graph View let you connect ideas the way the brain actually works - as a network, not a hierarchy of folders nested inside other folders.
Future-proof format: Plain .md files will be readable in 20 years. You’re never locked into proprietary software.
Frontmatter as a superpower: Combined with the Dataview plugin, you can query your notes like SQL - filter by tag, date range, status, or any custom field you define.
Callouts beat highlighting: Instead of painting text yellow, use [!TIP] or [!WARNING] to categorize information by type and priority.
Fully portable: Your Obsidian vault is just a folder. Sync it via iCloud, OneDrive, or Git - no proprietary sync service required.
A Practical Note-Taking Workflow
- Create a new note:
Ctrl/Cmd + N - Add frontmatter at the top (title, date, tags)
- Write with H2/H3 headings to create structure - the Outline panel generates automatically
- Link with
[[]]whenever you mention a concept that has its own note - Use callouts to mark insights worth remembering
- Review Graph View periodically to see where your knowledge network is dense and where it has gaps
FAQ
Do I need to memorize all this syntax?
No. The most commonly used syntax - headings, bold, bullets, wikilinks - becomes automatic within a week of daily use. For everything else, Obsidian has a command palette (Ctrl/Cmd + P) and many users keep a quick reference note in their vault.
What's the difference between tags and wikilinks?
Tags (#tag) are labels for categorizing notes - useful for filtering. Wikilinks ([[note]]) create actual connections between notes that appear in Graph View and Backlinks. For building a connected knowledge base, wikilinks are more powerful. Tags work well for status labels (draft, published, review) or broad topic categories.
Can I use Obsidian's Markdown in other tools?
Standard Markdown syntax (headings, bold, lists, code blocks) works in most Markdown editors. Obsidian-specific syntax like wikilinks ([[]]) and callouts (> [!NOTE]) are Obsidian extensions - they won’t render correctly in other tools unless those tools also support them (some do, like GitHub for callouts).
What is Dataview and should I install it?
Dataview is a community plugin that lets you query your vault’s frontmatter like a database using a SQL-like syntax. It’s extremely powerful for project tracking, content calendars, reading lists, and any use case where you want dynamic, auto-updating lists of notes. If you’re using frontmatter at all, Dataview is worth installing.