Obsidian - Sublime Text

TL;DR

Dead gray links in Obsidian often come from migrated RealmWorks link spam and can create empty “dead” notes when clicked.

Briefing Cornell Notes

Briefing

Migrating a large knowledge base from RealmWorks into Obsidian often leaves behind thousands of “dead” links—references that point to templates or notes that no longer exist. The practical fix is to clean those links in bulk, and the workflow here uses Sublime Text as a fast, reliable text editor to search-and-replace across entire Obsidian vault folders.

The cleanup problem shows up immediately in Obsidian preview: links that were created automatically in RealmWorks appear gray (meaning they don’t resolve to real notes). When those links are clicked, they can generate empty notes with the same names—creating clutter and “dead notes” that don’t lead anywhere. Manually removing links one by one is workable for a few pages, but it becomes painfully inefficient when dealing with hundreds of articles and link spam.

Sublime Text is introduced as the bulk-edit tool. After downloading and installing it from sublimetext.com, the workflow starts by opening the folder that contains the Obsidian notes to be cleaned. From there, “Find in files” is used: paste the exact text (including the bracketed link syntax) that needs to be removed or changed, then run Replace across the folder. In the demo, removing a broken reference (e.g., “curse of strad” wrapped in Obsidian-style brackets) is done by replacing the bracketed form with plain text. The search reports how many matches were found and in how many files, and “Save all” applies the changes across the vault. Similar steps remove other unwanted references (like “brovia”), again using global replacement rather than editing each note.

The same mechanism can also update links in bulk—turning plain text into proper Obsidian links. A key caution is emphasized: replacing a generic word can unintentionally rewrite many unrelated instances. The safer approach is to target named entities (like “mum” as a specific topic) and to limit the operation to one or two folders at a time. The demo shows replacing occurrences of “mum” with a link to the “mum” topic, with the result immediately visible in Obsidian as links that now resolve correctly.

A second cleaning technique addresses pasted content from external websites. HTML copied from the web can bring along embedded links that point outside the vault. To keep everything self-contained inside Obsidian, the workflow uses a “paste without formatting/links” style shortcut (Control Shift V) after selecting and deleting the pasted block, producing clean text without the unwanted hyperlink markup.

Overall, the method is about speed and control: use Sublime Text’s folder-wide search-and-replace to remove dead links, convert selected terms into real Obsidian links, and strip external hyperlink clutter during paste operations—making the migrated vault readable again without spending days clicking through notes.

Cornell Notes

RealmWorks-to-Obsidian migrations can leave behind gray, non-resolving links that clutter a vault and can even trigger empty “dead” notes. Bulk cleanup is done with Sublime Text by opening the Obsidian vault folder and using “Find in files” to replace exact bracketed link text across many notes at once. The workflow supports both directions: removing broken links by replacing bracketed syntax with plain text, and fixing references by replacing a term with a properly formatted Obsidian link. Updating links in bulk requires caution—generic words can be replaced everywhere—so it’s best to target named entities and limit changes to a small set of folders. For pasted web content, using a “paste without formatting/links” shortcut (Control Shift V) prevents external HTML links from entering the vault.

Why do gray links become a bigger problem after migrating from RealmWorks into Obsidian?

Gray links in Obsidian indicate the link target doesn’t exist as a real note. Clicking them is problematic because Obsidian may create an empty note with the same name, which adds clutter. When RealmWorks generated links broadly (sometimes to everything), the vault can end up with many unresolved references that make reading and navigation harder.

How does Sublime Text speed up removing dead Obsidian links across many notes?

Open the folder containing the Obsidian notes in Sublime Text, then use “Find in files.” Paste the exact bracketed link text you want to remove (the bracketed form from Obsidian), and replace it with plain text (removing the brackets). The tool reports the number of occurrences and which files contain them, then “Save all” applies the change across the folder—far faster than editing notes one by one.

What’s the risk when using bulk replace to create links, and how is it mitigated?

Bulk replacement can unintentionally rewrite many unrelated instances if the search term is generic (e.g., common words like “jump,” “run,” or “roll”). The mitigation is to replace only named entities or specific terms that correspond to actual topics, and to run the operation on one or two folders at a time so the blast radius stays small.

How can bulk replace turn plain text into working Obsidian links?

Use “Find in files” to search for the plain term (e.g., “mum”) and replace it with the Obsidian link syntax pointing to the correct note (e.g., a bracketed link to the “mum” topic). After saving, Obsidian preview shows the term as a real link that resolves to the intended note.

How does the workflow prevent external website links from polluting an Obsidian vault during paste?

When copying from a website, the clipboard may include HTML with embedded hyperlinks. The workflow selects and deletes the pasted block, then pastes again using Control Shift V, which pastes clean text without the hyperlink markup. This keeps links inside the vault and under the user’s control.

Review Questions

When removing dead links in bulk, what exactly should be replaced (bracketed link syntax vs plain text), and what should it be replaced with?
Why is it safer to bulk-replace named entities than generic words when converting text into Obsidian links?
What does Control Shift V accomplish compared with a normal paste when importing content from a website?

Key Points

1
Dead gray links in Obsidian often come from migrated RealmWorks link spam and can create empty “dead” notes when clicked.
2
Bulk cleanup is fastest by using Sublime Text’s “Find in files” on the entire Obsidian vault folder rather than editing notes individually.
3
To remove broken links, replace the bracketed Obsidian link text with plain text (dropping the brackets).
4
To fix references, replace a targeted term with proper Obsidian link syntax so the term resolves to an existing note.
5
Bulk link creation is risky for generic words; prefer named entities and limit changes to a small number of folders.
6
When pasting from websites, use Control Shift V to avoid importing HTML hyperlinks and keep content self-contained inside the vault.

Highlights

Gray links in Obsidian signal missing targets and can spawn empty notes—so link cleanup matters for vault hygiene.

Sublime Text can replace bracketed link syntax across dozens of files in one pass, with match counts reported before saving.

Bulk link creation works best for named entities; generic words can trigger widespread unintended replacements.

Control Shift V helps paste clean text without external hyperlink markup from copied HTML. 

Topics

Obsidian Link Cleanup
Sublime Text Bulk Replace
RealmWorks Migration
Dead Notes
Paste Without Links