Note-Taking in Foam
Effective note-taking is the foundation of any knowledge management system. In Foam, you’ll write notes in Markdown, a simple and powerful format that’s both human-readable and widely supported. This guide will teach you everything you need to know about writing great notes in Foam.
Markdown Basics
Section titled “Markdown Basics”Markdown is a lightweight markup language that uses simple syntax to format text. Here are the essentials:
Headings
Section titled “Headings”# Heading 1 (Main Title)
## Heading 2 (Major Section)
### Heading 3 (Subsection)
#### Heading 4 (Minor Section)Text Formatting
Section titled “Text Formatting”**Bold text**_Italic text_**_Bold and italic_**~~Strikethrough~~`Inline code`## Unordered Lists
- First item- Second item - Nested item - Another nested item
## Ordered Lists
1. First step2. Second step 1. Sub-step 2. Another sub-stepLinks and Images
Section titled “Links and Images”[External link](https://example.com)Code Blocks
Section titled “Code Blocks”```javascriptfunction greet(name) { return `Hello, ${name}!`;}```Tables
Section titled “Tables”| Column 1 | Column 2 | Column 3 || -------- | -------- | -------- || Data 1 | Data 2 | Data 3 || Data 4 | Data 5 | Data 6 |Quotes and Dividers
Section titled “Quotes and Dividers”> This is a quote or important note> It can span multiple lines
---
Use three dashes for horizontal dividers[📹 Watch: Markdown syntax essentials for note-taking]
Foam-Specific Features
Section titled “Foam-Specific Features”Beyond standard Markdown, Foam adds several powerful features:
Wikilinks
Section titled “Wikilinks”Connect your notes with double brackets:
I'm reading about [[Project Management]] and its relationship to [[Personal Productivity]].
This connects to [[2025-01-25-daily-note]] where I first had this insight.Note Embedding
Section titled “Note Embedding”Include content from other notes via Note Embeds:
![[Project Management#Key Principles]]
This embeds the "Key Principles" section from the Project Management note.Organize your content with Tags:
#productivity #learning #foam
Tags can be anywhere in your note and help with organization and filtering.Use nested tags for better organization:
#learning/programming/javascript#personal/health/exerciseThose tags will show as a tree structure in the Tag Explorer
Note Properties (YAML Front Matter)
Section titled “Note Properties (YAML Front Matter)”Add metadata to your notes:
---title: 'Advanced Note-Taking Strategies'tags: [productivity, learning, methods]created: 2025-01-25modified: 2025-01-25status: draft---
# Advanced Note-Taking Strategies
Your note content goes here...Writing Effective Notes
Section titled “Writing Effective Notes”The Atomic Principle
Section titled “The Atomic Principle”Each note should focus on one concept or idea:
Good Example:
# The Feynman Technique
A learning method where you explain a concept in simple terms as if teaching it to someone else.
## Steps
1. Choose a topic to learn2. Explain it in simple terms3. Identify gaps in understanding4. Simplify and use analogies
## Why It Works
- Forces active engagement with material- Reveals knowledge gaps quickly- Improves retention through teaching
Related: [[Active Learning]] [[Study Methods]]Avoid: Mixing multiple unrelated concepts in one note.
Use Descriptive Titles
Section titled “Use Descriptive Titles”Your note titles should clearly indicate the content:
Good: REST API Design Principles
Good: Meeting Notes - Product Roadmap Review 2025-01-25
Avoid: Stuff I Learned Today
Avoid: Notes
Link Generously
Section titled “Link Generously”Don’t hesitate to create links, even to notes that don’t exist yet:
# Machine Learning Fundamentals
Machine learning is a subset of [[Artificial Intelligence]] that focuses on creating algorithms that can learn from [[Data]].
Key concepts include:
- [[Supervised Learning]]- [[Unsupervised Learning]]- [[Neural Networks]]- [[Feature Engineering]]
This connects to my work on [[Customer Behavior Analysis]] and [[Predictive Analytics]].Foam will create placeholder pages for missing notes, making it easy to fill in knowledge gaps later.
Keyboard Shortcuts
Section titled “Keyboard Shortcuts”Essential VS Code shortcuts for note-taking:
| Shortcut | Action |
|---|---|
Ctrl+N / Cmd+N | New file |
Ctrl+S / Cmd+S | Save file |
Ctrl+P / Cmd+P | Quick file open |
Ctrl+Shift+P / Cmd+Shift+P | Command palette |
Ctrl+K V / Cmd+K V | Open Markdown preview |
Ctrl+[ / Cmd+[ | Decrease indent |
Ctrl+] / Cmd+] | Increase indent |
Alt+Z / Option+Z | Toggle word wrap |
What’s Next?
Section titled “What’s Next?”Now that you understand note-taking basics:
- Navigation in Foam - Learn to move efficiently between notes with wikilinks
- Explore the graph view - Visualize the connections in your knowledge base
- Set up templates - Create reusable note structures
- Use daily notes - Establish a daily capture routine