diff --git a/docs/images/lib2-px_cylinder-1.JPG b/docs/images/lib2-px_cylinder-1.JPG
new file mode 100644
index 00000000..cc67dd68
Binary files /dev/null and b/docs/images/lib2-px_cylinder-1.JPG differ
diff --git a/docs/images/lib2-px_cylinder-2.JPG b/docs/images/lib2-px_cylinder-2.JPG
new file mode 100644
index 00000000..fcfd565c
Binary files /dev/null and b/docs/images/lib2-px_cylinder-2.JPG differ
diff --git a/docs/lib2-px_cylinder.md b/docs/lib2-px_cylinder.md
new file mode 100644
index 00000000..8ebe2c7a
--- /dev/null
+++ b/docs/lib2-px_cylinder.md
@@ -0,0 +1,33 @@
+# px_cylinder
+
+Returns points that can be used to draw a pixel-style cylinder.
+
+**Since:** 2.0
+
+## Parameters
+
+- `radius` : The radius of the cylinder. It also accepts a vector `[r1, r2]`. `r1` is the bottom radius and `r2` is the top radius of a cone.
+- `h` : The height of the cylinder or cone. 
+- `filled` : Default to `false`. Set it `true` if you want a filled cylinder.
+- `thickness`: Default to 1. The thickness when `filled` is `false`.
+
+## Examples
+
+	include <pixel/px_cylinder.scad>;
+
+	for(pt = px_cylinder([10, 15], 10)) {
+		translate(pt)
+			cube(1, center = true);
+	}
+
+![px_cylinder](images/lib2-px_cylinder-1.JPG)
+
+	include <pixel/px_cylinder.scad>;
+
+	for(pt = px_cylinder([20, 15], h = 10, thickness = 3)) {
+		translate(pt)
+			cube(1, center = true);
+	}
+	
+![px_cylinder](images/lib2-px_cylinder-2.JPG)
+