diff --git a/docs/lib2x-vx_intersection.md b/docs/lib2x-vx_intersection.md
new file mode 100644
index 00000000..fce6d296
--- /dev/null
+++ b/docs/lib2x-vx_intersection.md
@@ -0,0 +1,28 @@
+# vx_intersection
+
+Creates an intersection of two lists of points. 
+
+**Since:** 2.4
+
+## Parameters
+
+- `points1` : A list of points.
+- `points2` : A list of points.
+
+## Examples
+
+	use <voxel/vx_cylinder.scad>;
+	use <voxel/vx_sphere.scad>;
+	use <voxel/vx_intersection.scad>;
+
+	voxels = vx_intersection(
+		vx_cylinder([1, 8], 8, filled = true),
+		vx_sphere(8, filled = true)
+	);
+
+	for(pt = voxels) {
+		translate(pt)
+			cube(1, center = true);
+	}
+
+![vx_intersection](images/lib2x-vx_intersection-1.JPG)