diff --git a/building-blocks/autobase.md b/building-blocks/autobase.md
index fff99198..2418fe15 100644
--- a/building-blocks/autobase.md
+++ b/building-blocks/autobase.md
@@ -253,7 +253,7 @@ Triggered when the autobase view updates after `apply` has finished running.
 
 #### `base.on('interrupt', (reason) => { ... })`
 
-Triggered when `host.interrupt(reason)` is called in the `apply` handler. See [`host.interrupt(reason)`](#hostinterruptreason) for when interrupts are used.
+Triggered when `host.interrupt(reason)` is called in the `apply` handler. See [`host.interrupt(reason)`](#host.interrupt-reason) for when interrupts are used.
 
 #### `base.on('fast-forward', (to, from) => { ... })`
 
diff --git a/building-blocks/hyperbee.md b/building-blocks/hyperbee.md
index efe6799d..641cbb3e 100644
--- a/building-blocks/hyperbee.md
+++ b/building-blocks/hyperbee.md
@@ -215,7 +215,7 @@ Gets the key and value from a block number.
 
 #### **`const stream = db.replicate(isInitiatorOrStream)`** {#db.replicate}
 
-See more about how replicate works at [core.replicate](hypercore.md#const-stream-core.replicate-isinitiatororreplicationstream).
+See more about how replicate works at [core.replicate](hypercore.md#core.replicate).
 
 #### **`const batch = db.batch()`** {#db.batch}
 
diff --git a/building-blocks/hyperswarm.md b/building-blocks/hyperswarm.md
index 465547f8..5f3805a0 100644
--- a/building-blocks/hyperswarm.md
+++ b/building-blocks/hyperswarm.md
@@ -96,7 +96,7 @@ A [`HyperDHT`](./hyperdht.md) instance. Useful for lower-level control over Hype
 
 Returns a [`PeerDiscovery`](hyperswarm.md#peer-discovery) object.
 
-Start discovering and connecting to peers sharing a common topic. As new peers are connected, they will be emitted from the swarm as [`connection`](hyperswarm.md#swarmonconnection-socket-peerinfo) events.
+Start discovering and connecting to peers sharing a common topic. As new peers are connected, they will be emitted from the swarm as [`connection`](hyperswarm.md#swarm.onconnection) events.
 
 `topic` must be a 32-byte Buffer and use a publicly sharable id, typically a Hypercore `discoveryKey` which we can then link to (join will leak the `topic` to DHT nodes).
 
diff --git a/helpers/localdrive.md b/helpers/localdrive.md
index 7228fae3..fb9fe3c0 100644
--- a/helpers/localdrive.md
+++ b/helpers/localdrive.md
@@ -148,7 +148,7 @@ Returns a stream of all subpaths of entries in drive stored at paths prefixed by
 
 Mirrors this drive into another. Returns a [`MirrorDrive`](../helpers/mirrordrive.md) instance constructed with `options`.
 
-Call [`await mirror.done()`](../helpers/mirrordrive.md#await-mirrordone) to wait for the mirroring to finish.
+Call [`await mirror.done()`](../helpers/mirrordrive.md#await-mirror.done) to wait for the mirroring to finish.
 
 **`const rs = drive.createReadStream(key, [options])`**
 
@@ -200,4 +200,4 @@ const drive = new Localdrive('./my-app', { metadata })
 
 ```javascript
 await drive.put('/file.txt', Buffer.from('a')) // Default metadata is null
-```
\ No newline at end of file
+```