1 files changed, 28 insertions, 1 deletions

diff --git a/subplot.md b/subplot.md
index d975e97..a73b805 100644
--- a/subplot.md
+++ b/subplot.md
@@ -2178,8 +2178,35 @@ It does not have a YAML metadata block.
 ~~~~~~~~
 
 
+# Extract embedded files
+
+`sp-extract` extracts embedded files from a subplot file.
+
+~~~scenario
+given file embedded-file.md
+and file expected.txt
+when I run sp-extract embedded-file.md foo.txt -d .
+then files foo.txt and expected.txt match
+~~~
+
+~~~~~~{#embedded-file.md .file .markdown .numberLines}
+---
+title: Embedded file
+...
+
+~~~{#foo.txt .file}
+This is a test file.
+~~~
+
+~~~~~~
+
+~~~{#expected.txt .file}
+This is a test file.
+~~~
+
+
+
 
-  
 ---
 title: "Subplot"
 author: The Subplot project