All templates

Automated Obsidian Broken Link Audits

Every Monday, WebRun opens your Obsidian vault, follows the links between notes, finds links pointing at notes that no longer exist and notes with no backlinks at all, builds a repair list on a Trello card, and drafts you a Gmail summary of what needs fixing.

Runs on WebRun · Strict Lockdown policy
Every Monday at 8:00 AM WebRunorchestrates each step
1 Obsidian find broken links and orphans
2 Trello build the repair list
3 Gmail draft the weekly summary
In short

How do I find broken links and orphaned notes in my Obsidian vault?

WebRun walks your Obsidian vault every Monday, following the links between notes to find links pointing at notes that no longer exist and notes with no backlinks at all. It builds the repair list on a Trello card and drafts a Gmail summary, so research written months ago is still reachable.

  • Broken links surface weekly instead of at the moment you need the note
  • Orphaned notes are listed with their last edit date
  • Counts are compared week over week, so the vault trend is visible

Built for researchers · writers · knowledge workers · students

Step by step

What does WebRun do on every run?

The exact actions WebRun takes, in order - in plain language, so you can adjust anything.

  1. WebRun signs in and gets to work

    Opens obsidian.md in a real browser with your saved login - no setup, no API keys.

  2. 1
    Obsidian - find broken links and orphans
    obsidian.md
    WebRun in Obsidian: find broken links and orphans
    WebRun opens Obsidian to find broken links and orphans.
    • Open your Obsidian vault and walk the notes folder by folder
    • Follow every internal link and record the ones pointing at a note that no longer exists
    • Note which note each broken link sits in and the text it was meant to point at
    • List notes with no backlinks and no links out, so nothing links to them and they lead nowhere
    • Check unlinked mentions where a note name appears as plain text and could be linked

    Done when Every broken link and orphaned note in the vault is listed with its location.

  3. 2
    Trello - build the repair list
    trello.com
    WebRun in Trello: build the repair list
    WebRun opens Trello to build the repair list.
    • Create this week's repair card on your notes board
    • List broken links first, grouped by the folder they live in
    • Add orphaned notes as a second checklist with the date each was last edited
    • Include unlinked mentions as a third, lower priority group
    • Leave the vault untouched. WebRun reports the repairs, it does not rewrite your notes

    Done when This week's repair list is on a single Trello card.

  4. 3
    Gmail - draft the weekly summary
    gmail.com
    WebRun in Gmail: draft the weekly summary
    WebRun opens Gmail to draft the weekly summary.
    • Draft an email summarising the counts: broken links, orphans, unlinked mentions
    • Name the folders with the most breakage so a fix session has a starting point
    • Show how the counts moved since last week
    • Leave the summary in drafts for you to read or forward

    Done when A weekly audit summary is waiting in Gmail.

Run settings

How is each run configured?

Starting pageWhere Chrome opens at the start of each run
obsidian.md
ScheduleRuns automatically on this cadence
Every Monday at 8:00 AM
DeliveryHow each run's result reaches you
Repair list · Trello
OutputWhat each run produces - A weekly repair list of broken internal links, orphaned notes, and unlinked mentions, grouped by folder.
Text
Setup & safety

Secure by default

Connect once, stays signed in

WebRun signs in once and keeps each session in a persistent environment, so every run picks up right where it left off.

Your credentials stay in your own private environment - WebRun never stores your passwords.
Strict Lockdown

Every action is checked against this policy before it runs.

Domains ALLOWLIST
Typed input ALLOW
Shell command BLOCK
File uploads BLOCK
Runs in a contained environment More on policies
Good to know

Questions, answered

Will it edit or delete my notes?

No. WebRun reads the vault and reports what it finds. It never rewrites a link, renames a note, or deletes anything. Every repair is made by you, with the list already prepared.

What counts as an orphaned note?

A note with no backlinks pointing at it, so nothing in the vault leads there. Each one is listed with the date it was last edited, so an old research note is easy to tell from a new draft.

Does it send the summary email automatically?

No. The weekly summary is left as a Gmail draft. Nothing is sent unless you open the draft and send it yourself, which matters if you forward it to a research group.

Put this on autopilot.

Turn it on in minutes - or have our team set it up for you.