diff --git a/doc/api/fs.md b/doc/api/fs.md
index fb4a625b863240..5e349c445a9b9a 100644
--- a/doc/api/fs.md
+++ b/doc/api/fs.md
@@ -1007,6 +1007,34 @@ property indicating whether parent directories should be created. Calling
 `fsPromises.mkdir()` when `path` is a directory that exists results in a
 rejection only when `recursive` is false.
 
+```mjs
+import { mkdir } from 'node:fs/promises';
+
+try {
+  const projectFolder = new URL('./test/project/', import.meta.url);
+  const createDir = await mkdir(path, { recursive: true });
+
+  console.log(`created ${createDir}`);
+} catch (err) {
+  console.error(err.message);
+}
+```
+
+```cjs
+const { mkdir } = require('node:fs/promises');
+const { resolve, join } = require('node:path');
+
+async function makeDirectory() {
+  const projectFolder = join(__dirname, 'test', 'project');
+  const dirCreation = await mkdir(projectFolder, { recursive: true });
+
+  console.log(dirCreation);
+  return dirCreation;
+}
+
+makeDirectory().catch(console.error);
+```
+
 ### `fsPromises.mkdtemp(prefix[, options])`
 
 <!-- YAML
@@ -1035,7 +1063,7 @@ The optional `options` argument can be a string specifying an encoding, or an
 object with an `encoding` property specifying the character encoding to use.
 
 ```mjs
-import { mkdtemp } from 'fs/promises';
+import { mkdtemp } from 'node:fs/promises';
 
 try {
   await mkdtemp(path.join(os.tmpdir(), 'foo-'));