YouTip

Markdown is the underlying markup language for Obsidian.\\n\\nMarkdown uses plain text symbols to express formatting, allowing you to keep your hands on the keyboard while writing and focus on content rather than typesetting.\\n\\nThis chapter covers the most commonly used Markdown syntax in daily Obsidian use. All examples can be practiced directly in Obsidian.\\n\\n!(#)\\n\\n> For more Markdown content, refer to: [\\n\\n* * *\\n\\n## Headings\\n\\nMarkdown uses # symbols to indicate headings, with quantities from 1 to 6 corresponding to H1 to H6.\\n\\nIn Obsidian, headings have two additional functions: the outline panel automatically generates a document directory based on headings, and other notes can link directly to a specific heading position using [[Note Title#Heading]].\\n\\n## Examples\\n\\n# Heading 1\\n\\n## Heading 2\\n\\n### Heading 3\\n\\n#### Heading 4\\n\\n##### Heading 5\\n\\n###### Heading 6\\n\\n> It is recommended to start the main text from the second-level heading, leaving the first-level heading for the note's main title. This makes the outline structure clearer and facilitates locating content through heading references in the future.\\n\\n* * *\\n\\n## Text Formatting\\n\\nBasic inline styles can be applied by wrapping text with the following symbols.\\n\\n## Examples\\n\\n**This is bold**\\n\\n __This is also bold__\\n\\n*This is italic*\\n\\n _This is also italic_\\n\\n***This is bold italic***\\n\\n~~This is strikethrough~~\\n\\n==This is highlighted==\\n\\nRendering effect:\\n\\n* Bold: **This is bold**\\n* Italic: _This is italic_\\n* Bold Italic: **_This is bold italic_**\\n* Strikethrough: ~~This is strikethrough~~\\n* Highlight: This is highlighted\\n\\nAmong these, ==Highlight== is an extended syntax specific to Obsidian and may not work in standard Markdown editors.\\n\\n* * *\\n\\n## Blockquotes\\n\\nUse the > symbol to create blockquotes, suitable for quoting external sources or highlighting important content.\\n\\n## Examples\\n\\n> This is a blockquote\\n\\n> This is another blockquote\\n\\n> Can span multiple lines\\n\\n>### Headings can be nested in blockquotes\\n\\n>\\n\\n> Any Markdown syntax can be used inside a blockquote:\\n\\n> - List item\\n\\n> - **Bold text**\\n\\nIn Obsidian, blockquotes have a special usage: adding annotations like [!note] before the quote turns it into a Callout alert box.\\n\\n## Examples\\n\\n>[!note] Tips\\n\\n> This is a Callout TipsBox, which is more eye-catching than a standard blockquote.\\n\\n>[!warning] Note\\n\\n> Deleting a Vault will also delete local files, please confirm before proceeding.\\n\\n>[!tip] Tips\\n\\n> By Cmd+P Open the Command Palette to search and execute all Obsidian commands.\\n\\n* * *\\n\\n## Lists and Task Lists\\n\\n### Unordered Lists\\n\\nUse -, *, or + to create unordered lists.\\n\\nSub-lists are indicated by indentation (Tab or two spaces) to show hierarchy.\\n\\n## Examples\\n\\n- Programming Language\\n\\n - Python\\n\\n - JavaScript\\n\\n - Go\\n\\n - Database\\n\\n - Relational\\n\\n - MySQL\\n\\n - PostgreSQL\\n\\n - Non-relational\\n\\n - MongoDB\\n\\n - Redis\\n\\n### Ordered Lists\\n\\nUse numbers followed by . to create ordered lists. The numbers themselves don't need to be consecutive, as Markdown will automatically increment them.\\n\\n## Examples\\n\\n1. Open Obsidian\\n\\n2. Create New Vault\\n\\n3. Create a new note\\n\\n4. Start Writing\\n\\n### Task Lists\\n\\nUse - to create clickable checkboxes, which is one of the most frequently used syntaxes in Obsidian.\\n\\n## Examples\\n\\n## Today's To-Do\\n\\n- [] Finished reading Chapter 3 of 'Computer Systems: A Programmer's Perspective'\\n\\n - [] Organize this week's study notes\\n\\n - Complete Obsidian environment setup\\n\\n - Learn Markdown basic syntax\\n\\nIn Obsidian, you can click the checkbox to toggle its completion status.\\n\\nCombined with the Dataview plugin, you can also aggregate all unfinished tasks across notes—this advanced usage will be introduced in subsequent chapters.\\n\\n* * *\\n\\n## Code and Code Blocks\\n\\n### Inline Code\\n\\nWrap inline code or commands with single backticks `.\\n\\n## Examples\\n\\nRun in terminal `npm install` Install dependencies.\\n\\n Python in the `print()` The function is used to output Content.\\n\\n### Code Blocks\\n\\nWrap multi-line code with three backticks ``` and specify the language at the beginning for syntax highlighting.\\n\\n## Examples\\n\\n```python\\n\\n# File path: hello.py\\n\\n def greet(name):\\n\\n"""Greet a specific user"""\\n\\nreturn f"Hello, {name}!"\\n\\n# Call function and print result\\n\\n result = greet("tutorial")\\n\\n print(result)\\n\\nObsidian supports syntax highlighting for dozens of programming languages, including Python, JavaScript, C++, Java, Go, Rust, SQL, Bash, and more.\\n\\n* * *\\n\\n## Tables\\n\\nUse | to separate columns and --- to separate the header from the body.\\n\\nUse : in the --- row to control alignment.\\n\\n## Examples\\n\\n| Language | Birth year | Founder |\\n\\n|------|:--------:|-------|\\n\\n| Python |1991| Guido van Rossum |\\n\\n| JavaScript |1995| Brendan Eich |\\n\\n| Go |2009| Robert Griesemer, Rob Pike, Ken Thompson |\\n\\n| Rust |2010| Graydon Hoare |\\n\\nAlignment rules:\\n\\n* --- default left alignment\\n* :---: center alignment\\n* ---: right alignment\\n\\n> Markdown tables do not support merged cells. For complex tables, consider using HTML's `` tag—Obsidian supports embedding HTML directly in Markdown files.\\n\\n* * *\\n\\n## Images and Links\\n\\n### Hyperlinks\\n\\nThe basic syntax is (URL).\\n\\n## Examples\\n\\n(#)\\n\\n(https://github.com "Title text displayed on hover")\\n\\n### Images\\n\\nThe syntax is similar to links, with an added ! at the beginning.\\n\\nObsidian supports pasting images directly, which will automatically be copied to the attachments folder and referenced in the current note.\\n\\n## Examples\\n\\n\\n\\n!(#)\\n\\n\\n\\n!(attachments/architecture.png)\\n\\n\\n\\n\\n\\nObsidian extends the image syntax by allowing |width after the filename to control display size. For example,  limits the image width to 400 pixels.\\n\\n### Obsidian Exclusive: Internal Links\\n\\nIn addition to standard Markdown links, Obsidian provides the [] syntax to link to other notes in the Vault.\\n\\nThis is the core syntax of Obsidian and will be explored in detail in the next chapter.\\n\\n* * *\\n\\n## Horizontal Rules\\n\\nUse three or more ---, ***, or ___ on a line by themselves to create horizontal rules.\\n\\n## Examples\\n\\n## Part One\\n\\nContent...\\n\\n---\\n\\n## Part 2\\n\\nContent...\\n\\n> Note the distinction: --- on its own line is a horizontal rule, but --- at the very top of a document encloses YAML Front Matter (see next section). Obsidian automatically recognizes the context to determine whether it's a horizontal rule or Front Matter.\\n\\n* * *\\n\\n## YAML Front Matter\\n\\nFront Matter is a metadata block written at the very top of a note, wrapped by two sets of ---.\\n\\nIt is used to define the note's properties: tags, aliases, creation date, status, etc.\\n\\n## Examples\\n\\n---\\n\\n title: "Obsidian Study Notes"\\n\\n tags:\\n\\n- obsidian\\n\\n - markdown\\n\\n - Note-taking tool\\n\\n aliases:\\n\\n- Obsidian Getting Started\\n\\n - Second Brain Tutorial\\n\\n created: 2026-05-21\\n\\n status: In Progress\\n\\n---\\n\\nCommon Front Matter field descriptions:\\n\\n| Field | Type | Description |\\n| --- | --- | --- |\\n| tags | String or Array | Note tags, supports nesting such as programming/Python |\\n| aliases | String or Array | Note aliases, other notes can link to this note via aliases |\\n| created | Date | Creation date, can be automatically filled by the Templater plugin |\\n| updated | Date | Last update date, some plugins can maintain this automatically |\\n| status | String | Note status, such as "Draft", "In Progress", "Completed" |\\n\\n> Field names in Front Matter are case-sensitive. It is recommended to unify naming conventions within a team or project to avoid issues like tags and Tags being mixed up, which can cause Dataview queries to miss data.\\n\\nThe core value of Front Matter lies in its use with the Dataview plugin—you can query and filter all notes with the tag "obsidian" and status "In Progress" as if querying a database.\\n\\n* * *\\n\\n## Markdown Syntax Quick Reference\\n\\n| Element | Syntax | Quick Memory |\\n| --- | --- | --- |\\n| Heading | # H1## H2### H3 | Hash + space + text |\\n| Bold | **text** | Wrapped in double asterisks |\\n| Italic | *text* | Wrapped in single asterisk |\\n| Strikethrough | ~~text~~ | Wrapped in double tildes |\\n| Highlight | ==text== | Wrapped in double equals (Obsidian extension) |\\n| Inline Code | `code` | Wrapped in single backticks |\\n| Code Block | ```language | Three backticks + language name |\\n| Blockquote | > text | Greater-than sign + space |\\n| Unordered List | - item | Hyphen + space |\\n| Task List | - task | Hyphen + space + brackets |\\n| Link | (url) | Square brackets + parentheses |\\n| Image | !(url) | Exclamation mark + link syntax |\\n| Internal Link | [] | Double square brackets (Obsidian extension) |\\n| Table | | Column 1 | Column 2 | | Separated by vertical bars |\\n| Horizontal Rule | --- | Three hyphens on their own line |