diff --git a/src/docs/asciidoc/docker.adoc b/src/docs/asciidoc/docker.adoc
new file mode 100644
index 00000000..16ca5ccd
--- /dev/null
+++ b/src/docs/asciidoc/docker.adoc
@@ -0,0 +1,9 @@
+== Docker image
+
+The Swagger2Markup-CLI has been published as a Docker image on DockerHub. You can pull the image:
+
+`docker pull swagger2markup/swagger2markup`
+
+You can convert a Swagger Spec by running a Docker container:
+
+`docker run --rm -v $(pwd)/in:/tmp/in -v $(pwd)/out:/tmp/out swagger2markup/swagger2markup convert -i /tmp/in/swagger.yaml -c /tmp/in/config.properties -f /tmp/out/swagger`
\ No newline at end of file
diff --git a/src/docs/asciidoc/index.adoc b/src/docs/asciidoc/index.adoc
index 0f2c4df6..ebd990c7 100644
--- a/src/docs/asciidoc/index.adoc
+++ b/src/docs/asciidoc/index.adoc
@@ -26,6 +26,8 @@ include::maven_plugin.adoc[]
 
 include::command_line_interface.adoc[]
 
+include::docker.adoc[]
+
 include::demo.adoc[]
 
 include::contributing.adoc[]