diff --git a/.markdownlint.json b/.markdownlint.json
new file mode 100644
index 0000000..de99382
--- /dev/null
+++ b/.markdownlint.json
@@ -0,0 +1,8 @@
+{
+ "MD013": {
+ "line_length": 100,
+ "tables": false,
+ "code_blocks": false
+ },
+ "MD033": false
+}
diff --git a/README.md b/README.md
index ac4baf7..04b3c5c 100644
--- a/README.md
+++ b/README.md
@@ -135,6 +135,22 @@ available:
Put your template files anywhere, and fill them with tokens for replacement.
+Each template (not file) in the config array is parsed individually, and copied to the output
+directory. If a single template path contains multiple files (e.g. if you use a folder path or a
+glob pattern), the first directory up the tree of that template will become the base inside the
+defined output path for that template, while copying files recursively and maintaining their
+relative structure.
+
+Examples:
+
+> In the following examples, the config `name` is `AppName`, and the config `output` is `src`.
+
+| Input template | Output path(s) |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| `./templates/{{ name }}.txt` | `src/AppName.txt` |
+| `./templates/directory`
Directory contents: