diff --git a/docs/modules/js-yaml.md b/docs/modules/js-yaml.md
index 96bd7094..db0c9995 100644
--- a/docs/modules/js-yaml.md
+++ b/docs/modules/js-yaml.md
@@ -11,3 +11,18 @@
 [Project Page](https://eemeli.org/yaml/)
 
 [npm](https://www.npmjs.com/package/yaml)
+
+### Bun API
+
+[Since Bun v1.2.21, YAML parsing is built in](https://bun.com/blog/release-notes/bun-v1.2.21#native-yaml-support) via the `YAML` namespace:
+
+```js
+import { YAML } from "bun";
+
+console.log(YAML.parse("123"));        // 123
+console.log(YAML.parse("null"));       // null
+console.log(YAML.parse("false"));      // false
+console.log(YAML.parse("abc"));        // "abc"
+console.log(YAML.parse("- abc"));      // [ "abc" ]
+console.log(YAML.parse("abc: def"));   // { "abc": "def" }
+```