diff --git a/docs/api.md b/docs/api.md
index b69b0f3027..5eb9217c27 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -177,7 +177,7 @@ await sleep(1000)
 
 ## `echo()`
 
-A `console.log()` alternative which can take [ProcessOutput](#processoutput).
+A `console.log()` alternative which can take [ProcessOutput](./process-output.md).
 
 ```js
 const branch = await $`git branch --show-current`
diff --git a/docs/configuration.md b/docs/configuration.md
index d13ef2aeef..330074a166 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -95,7 +95,7 @@ Defaults to `process.env`.
 
 Specifies a current working directory of all processes created with the `$`.
 
-The [cd()](#cd) func changes only `process.cwd()` and if no `$.cwd` specified,
+The [cd()](./api.md#cd) func changes only `process.cwd()` and if no `$.cwd` specified,
 all `$` processes use `process.cwd()` by default (same as `spawn` behavior).
 
 ## `$.log`