Skip to content
Workflows8 min read

Obsidian Aliases vs Display Text: Choose the Right Same-Name Note

Choose Obsidian aliases or local display text when short names collide. Use a worked two-book example to identify the intended source and check the link.

·By Taha Baalla

A short name is convenient until it describes two different things you genuinely need to keep. This guide uses two invented books to explain that decision. It does not report a tested vault, automatic disambiguation or a guarantee about suggestion order.

Begin with the reference your sentence needs

Imagine two invented books named “Orchard,” one by the fictional author Maya Chen and another by the fictional author Owen Reed. No real publications or authors are being described. You keep a separate reading note for each. A project note says, “Compare the ending with Orchard,” but the short title does not tell a future reader which book you meant.

Before making a link, finish the thought in ordinary language: “Compare the ending with Owen Reed's Orchard.” That sentence identifies the reference your argument needs. The link should carry that meaning rather than merely matching the most familiar-looking suggestion.

If you accidentally select Maya Chen's note, the link can still open successfully and display the word Orchard. The failure is semantic: your reader reaches the wrong book and may interpret your comparison against the wrong source.

Our research app guide covers wider reference-tool choices. This task concerns choosing an intended meaning inside your existing notes, not finding a prettier label for an otherwise settled destination.

Separate alternate names, destinations and local wording

Obsidian defines an alias as an alternative name for a note, including abbreviations or nicknames. Add it through the note's aliases property; the documentation requires a YAML list. Alias suggestions can be selected when creating an internal link, with the real target retained and the alias used as display text. Alias documentation

Display text changes how an individual link reads. Obsidian's link guide distinguishes that local wording from a reusable alias. Internal-link documentation

Apply those roles to the fictional books:

ComponentProposed examplePurpose
Qualified note identityOrchard — Owen ReedDistinguish the actual reference
Alternative nameA name you genuinely reuse for this bookHelp recall the same reference by another name
Local display wordingOwen Reed's endingExplain this particular comparison

These are descriptive components, not executable link syntax. The table does not create notes or establish that an alias is unique.

Choose alternate names because they help you recall the intended source. Adding every vague word that appears in a book is not a substitute for knowing which book your sentence concerns.

Make the two meanings explicit before relying on a short name

For the hypothetical reading collection, keep enough identifying information visible in each note to distinguish the books. The author is useful here because the titles collide; another reference might require an edition, subject or organizational context.

Write a short identifying description near the top of each source note. For the invented books, that could state which author's work the note discusses and which part you read. Those descriptions are proposed editorial practice, not metadata that Obsidian independently verifies.

Now return to the project sentence. Ask which note contains the evidence needed for the comparison. If you cannot answer, defer creating the reference until you inspect the source material. A clickable guess is still a guess.

Do not solve the ambiguity by combining the two book notes simply because their titles match. They represent different sources. Likewise, an expanded label cannot rescue a destination that you have not identified correctly.

Create the reference, then check the source it opens

Use the documented internal-link workflow to choose the intended note. Obsidian's alias guide describes typing an alias while creating a link and selecting its suggestion. Selecting an alias

After creating the reference, open it and inspect a source-identifying detail. For the fictional project, confirm that the destination is Owen Reed's reading note and that it contains the ending discussed in your sentence.

Then read the project sentence again. Would someone unfamiliar with your shorthand understand which book is meant? If not, use clearer local wording. The purpose is not to repeat the entire catalog entry everywhere, but to include the distinction that matters in that context.

Record the limit of your check: this reference opens the intended note for this comparison. Do not extend that observation into a claim that every use of the short name elsewhere already points to the right meaning.

If a task instead requires renaming a file and checking existing targets, our Obsidian rename guide covers that different operation. Adding an alternate name is not a general repair of past references.

When both sources matter, write two explicit references

Suppose your project now compares both fictional books. A sentence such as “Orchard handles the ending differently” no longer communicates the intended relationship.

Write the distinction directly: “Compare the ending in Maya Chen's Orchard with the ending in Owen Reed's Orchard.” Give each reference its own correct destination. This preserves the fact that you are discussing two sources rather than one source under several names.

The same reasoning applies to a shared acronym with different meanings. Define the sense needed for the present task and make the contrast explicit if both senses belong in the discussion. Do not expect a repeated short form to carry a distinction that your prose never supplies.

Shorter wording is useful only while the reference remains understandable. If simplifying the label removes the very information that distinguishes the sources, the simplification has gone too far.

Review old mentions without assuming they share one meaning

Obsidian documents finding unlinked alias mentions through Backlinks and turning a chosen mention into an internal link. Unlinked alias mentions

Treat each candidate as a passage to read. In the fictional collection, an old sentence containing Orchard might refer to either book, both books or something unrelated. The visible word is evidence to inspect, not an instruction to assign every occurrence to the same destination.

Check the surrounding topic and any source-identifying detail. If the intended meaning remains unclear, leave the mention unlinked and add a review question if useful. Do not manufacture certainty by applying a convenient reference everywhere.

If you later change how you describe a source, check the relevant prose separately. A naming improvement does not automatically improve the argument or establish that a source supports your claim.

Our Obsidian live-embed guide covers whether reused source text should change with its source. That is another decision again: first choose the intended reference, then decide how much content and behavior the destination needs.

Keep a small naming rule tied to actual use

For the fictional books, the practical rule is simple: distinguish the source notes by author, add only alternative names you actually use, and make local wording explicit when the two works could be confused.

Use that rule on a few real references you can inspect rather than expanding a naming system merely to anticipate every possible collision. If a short name repeatedly causes uncertainty, improve the source distinction and the relevant prose before adding more shorthand.

Nemos is our own app, so weigh what we say about it with that in mind. Nemos keeps links, notes, screenshots and files in one library. Nemos lets you search saved links, notes and text in screenshots.

Those capabilities can support a separate working-reference collection. They do not establish Obsidian integration, alias disambiguation or automatic link correction. Keep the intended source and your actual inspection explicit.

FAQ

Does an alias rename the note?

No. It provides an alternative name for the reference. Keep the actual destination distinct from the wording you use to recall or display it, especially when several sources share a short title.

Should I add an alias just to change one sentence's link wording?

Use local display text when the wording belongs to that one context. Reserve reusable alternate names for ways you actually refer to the same source across your notes.

What if two notes can both be called the same thing?

Identify the meaning required by the current passage and inspect the selected destination. If both sources matter, write two explicit references; do not let one ambiguous label conceal the distinction.

Sources

Last reviewed: 2026-11-18. Documentation-backed guidance with fictional books and proposed reference checks; no performed vault or linking test.

TB
·Founder, Nemos

Taha built Nemos after years of losing screenshots and voice memos across a dozen apps. He writes about on-device AI, personal knowledge management, and building privacy-first tools for iPhone.

@nemosapp
Free on iPhone and iPad

Stop losing things you save.

Nemos remembers every screenshot, voice memo, link, and note — and surfaces them when you need them. Free, private, on-device AI.

Free to download · No credit card · Sign in with Apple

More from the blog

Add Nemos as a preferred source on Google