1 files changed, 11 insertions, 0 deletions

diff --git a/README.md b/README.md
index b50182b..5330b0f 100644
--- a/README.md
+++ b/README.md
@@ -28,6 +28,17 @@ For instance:
 
 If no output file is specified, output is written to stdout instead.
 
+#### Images
+
+By default, images are included inline in the output HTML.
+If an output directory is specified by `--output-dir`,
+the images are written to separate files instead.
+For instance:
+
+    mammoth document.docx --output=output-dir
+
+#### Styles
+
 Custom styles can be read from a file using `--styles`.
 For instance: