1 files changed, 42 insertions, 0 deletions
diff --git a/docs/linking_to_external_code/import_maps.md b/docs/linking_to_external_code/import_maps.md
new file mode 100644
index 000000000..7ec963d39
--- /dev/null
+++ b/docs/linking_to_external_code/import_maps.md
@@ -0,0 +1,42 @@
+## Import maps
+
+> This is an unstable feature. Learn more about
+> [unstable features](../../runtime/unstable).
+
+Deno supports [import maps](https://github.com/WICG/import-maps).
+
+You can use import map with the `--importmap=<FILE>` CLI flag.
+
+Current limitations:
+
+- single import map
+- no fallback URLs
+- Deno does not support `std:` namespace
+- supports only `file:`, `http:` and `https:` schemes
+
+Example:
+
+```js
+// import_map.json
+
+{
+   "imports": {
+      "http/": "https://deno.land/std/http/"
+   }
+}
+```
+
+```ts
+// hello_server.ts
+
+import { serve } from "http/server.ts";
+
+const body = new TextEncoder().encode("Hello World\n");
+for await (const req of serve(":8000")) {
+  req.respond({ body });
+}
+```
+
+```shell
+$ deno run --importmap=import_map.json hello_server.ts
+```