1 files changed, 9 insertions, 0 deletions
diff --git a/README.md b/README.md
index ca83f13..c9fc732 100644
--- a/README.md
+++ b/README.md
@@ -36,6 +36,15 @@ 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-dir=output-dir
+
 ### Library
 
 #### Basic conversion