YouTip

Bidirectional links are the core capability that distinguishes Obsidian from traditional note-taking software. It's not just a simple hyperlink jump, but a mechanism that allows knowledge to "perceive" each other—when you connect two notes, this relationship is visible from both ends. * * * ## Internal Links: [] Syntax In Obsidian, you can create a link to another note by using []. After typing [[, Obsidian will automatically pop up a search box, supporting fuzzy matching of note names. ## Example ## My Study Notes When learning [], you need to first understand []. These concepts are also used in []. You can refer to the factory pattern implementation in []. Click the link to jump to the corresponding note. If the note being linked to doesn't exist yet, Obsidian will display it as a gray link, and clicking it will automatically create a corresponding empty note. This feature allows you to naturally build a knowledge framework by first drafting links and then filling in content note by note. ### Alias Links Sometimes the file name of a note isn't natural enough. Using the [[file name|display text]] syntax allows the link text to better fit the context. ## Example When learning object-oriented programming, [[python-oop-advanced-2024|Python Object-Oriented Programming Detailed Tutorial]] is a great reference article. A better approach is to set aliases in the Front Matter of the target note, after which all links pointing to that note can use the alias: ## Example --- aliases: - Python OOP - Python Object-Oriented Programming - Python Class Tutorial --- > Alias Recommended Usage: Define standard aliases in the note's Front Matter instead of using the pipe symbol | to temporarily rewrite each time. This way, aliases are managed uniformly, and one modification applies to the entire library. * * * ## Block References and Heading References In addition to linking entire notes, you can also precisely reference specific paragraphs or headings within a note. ### Heading References Use [[note name#heading]] to directly link to a specific heading location within a note. ## Example See the sample code in [[Python Basics#List Comprehension]]. For configuration methods, refer to [[Environment Setup#macOS Installation Steps]]. ### Block References Add a ^blockID at the end of the target paragraph, then reference that paragraph in other notes using [[note name#^blockID]]. ## Example List comprehension is a concise syntax for creating lists in Python, which allows you to write loops and conditional statements in a single line. ^list-comp-def Reference this paragraph block in another note: ## Example As mentioned in [[Python Basics#^list-comp-def]], list comprehension can greatly simplify code. Referenced blocks are displayed in the target note in an embedded rendering manner, showing the original content, not just as a jump link. ### Embedding Entire Notes or Paragraphs By adding an exclamation mark ! before the link ![], you can embed the complete content of the target note into the current note. ## Example ## Common Code Snippets ![] ![[Environment Setup#Environment Variable Configuration]] > Embedding is suitable for summary-type notes—for example, creating a "Common References" note that embeds content from multiple cheat sheet notes, forming a dashboard view. * * * ## Backlinks Panel This is one of the most valuable features of Obsidian. When you open a note, the "Backlinks" area in the right panel will list all other notes that reference the current note. For example, you wrote a "Closure" note. One day, when writing "Python Decorators," you linked to it. A few weeks later, you linked to it again in "JavaScript Advanced Functions." When you open "Closure," these connections automatically appear before you—no need for you to manually remember or maintain an index. ### Linked Mentions vs Unlinked Mentions The backlinks panel is divided into two areas: * Linked Mentions: Places where the [] syntax is explicitly used to link to the current note * Unlinked Mentions: Places where the title text of the current note is mentioned, but without adding [] links Unlinked Mentions is a powerful tool for discovering "missing links"—you may have mentioned the word "Closure" in several notes, but forgot to add the bi-link. * * * ## Knowledge Graph The knowledge graph displays the link relationships between notes in a visual way. ### Local Graph In any note, click "More Options → Open Local Graph" in the upper right corner to display the link network centered on the current note. The default display depth for the local graph is 1 layer (direct neighbors), which can be adjusted to 2-5 layers to see broader connections. ### Global Graph Click the graph icon in the left sidebar to view the link relationship graph of the entire library. Meaning of symbols in the graph: * Node size: The more times a note is linked to, the larger the node—naturally highlighting core concepts in your knowledge system * Line density: If two notes link to each other, the line is thicker * Node color: Can be assigned colors through grouping functions based on conditions like paths, tags, or file names ### Graph Grouping and Filtering In the settings of the global graph, you can create grouping rules: ## Example Group #1: Programming Notes - path: programming/ - Color: Blue Group #2: Reading Notes - path: view/readread/ - Color: Green Group #3: Diary - path: Journal/ - Color: Gray Through grouping, the graph can clearly show the scale and cross-relationships of different fields. Filters can hide nodes that don't need to be displayed based on keywords, tags, or file paths, preventing the graph from becoming too dense. > The graph is more like a mirror, reflecting your existing knowledge structure, rather than a navigation tool. Don't spend too much time making it "look good"—the real value is that it exposes isolated knowledge points and unexpected cross-domain connections. * * * ## Unlinked Mentions: Completing Your Knowledge Graph The Unlinked Mentions area at the bottom of the backlinks panel lists all places where the current note's title is mentioned but without bi-links. Regularly checking Unlinked Mentions is a low-cost way to organize knowledge: click the "Link" button next to each item to instantly add a []. This is similar to "filling gaps" in your knowledge network, turning originally invisible connections into explicit links. * * * ## Practical Tips for Bi-link Writing | Stage | Approach | | --- | --- | | While writing | Add [] boldly for any concepts you think of, even if the target note doesn't exist yet. Build the framework first, then fill in the content. | | After writing | Quickly scan through Unlinked Mentions and check other keywords mentioned during the writing process to confirm whether links should be added. | | Regular maintenance | Browse the global graph to observe if there are many isolated nodes. If so, consider connecting them to existing core notes. | | Avoid over-linking | Not every sentence needs to become a link. Only link to notes that substantially help understanding the current content—less is more. |