diff --git a/README.md b/README.md
index c85a486..92ddf5f 100644
--- a/README.md
+++ b/README.md
@@ -66,6 +66,27 @@ Theming is supported on per-diagram basis, through the mermaid's `%%init%%` attr
 
 To learn more, see the [Theming Section](https://mermaid-js.github.io/mermaid/#/theming) of the mermaid.js book
 
+### Separating diagrams from code
+
+A diagram can be loaded from file to reduce clutter in the documentation comments.
+
+Such diagram will always be placed under the rest of the document section. 
+Reading diagrams from file can be combined with placing them into the doc-comment, to get multiple diagrams describing a single entity, however only one can be placed inside the file. (FIXME).
+
+```rust
+#[cfg_attr(doc, aquamarine::aquamarine, path = "./diagram.mermaid")]
+pub fn example_foad_from_file() {}
+```
+
+```bash
+# diagram.mermaid
+graph LR
+    s([Source]) --> a[[aquamarine]]
+    r[[rustdoc]] --> f([Docs w/ Mermaid!])
+    subgraph rustc[Rust Compiler]
+    a -. load diagram.mermaid .-> r
+    end
+```
 
 ### In the wild
 
@@ -73,3 +94,6 @@ Crates that use `aquamarine` in their documentation
 
  - [google/autocxx](https://github.com/google/autocxx)
  - [replicadse/senile](https://github.com/replicadse/senile)
+ - [teloxide](https://github.com/teloxide/teloxide)
+ 
+[and other](https://crates.io/crates/aquamarine/reverse_dependencies)
\ No newline at end of file
diff --git a/demo/diagram.mermaid b/demo/diagram.mermaid
new file mode 100644
index 0000000..62ac7ef
--- /dev/null
+++ b/demo/diagram.mermaid
@@ -0,0 +1,6 @@
+graph LR
+    s([Source]) --> a[[aquamarine]]
+    r[[rustdoc]] --> f([Docs w/ Mermaid!])
+    subgraph rustc[Rust Compiler]
+    a -. load diagram.mermaid .-> r
+    end
\ No newline at end of file
diff --git a/demo/src/lib.rs b/demo/src/lib.rs
index 3c53fe6..480b28a 100644
--- a/demo/src/lib.rs
+++ b/demo/src/lib.rs
@@ -38,4 +38,12 @@ pub fn example() {}
 /// ```
 ///
 /// To learn more, see the [Theming Section](https://mermaid-js.github.io/mermaid/#/theming) of the mermaid.js book
-pub fn example_with_styling() {}
\ No newline at end of file
+pub fn example_with_styling() {}
+
+#[cfg_attr(doc, aquamarine::aquamarine, path = "./diagram.mermaid")]
+/// A diagram can be loaded from a file as well!
+/// 
+/// Reduce clutter in your doc comments, when a diagram is big enough
+///
+/// **Note:** diagrams loaded form file are always placed in the bottom of the doc section
+pub fn example_foad_from_file() {}