diff --git a/docs/examples.md b/docs/examples.md
index 8394a9b..376e458 100644
--- a/docs/examples.md
+++ b/docs/examples.md
@@ -13,6 +13,11 @@
 * Python Web Scraping (2nd Edition): [Exploring requests-cache](https://learning.oreilly.com/library/view/python-web-scraping/9781786462589/3fad0dcc-445b-49a4-8d5e-ba5e1ff8e3bb.xhtml)
 * Cui Qingcai: [一个神器，大幅提升爬取效率](https://cuiqingcai.com/36052.html) (A package that greatly improves crawling efficiency)
 
+<!--
+Explicit line numbers are added below to include the module docstring in the main doc, and put the
+rest of the module contents in a dropdown box.
+TODO: It might be nice to have a custom extension to do this automatically.
+-->
 ## Scripts
 The following scripts can also be found in the
 [examples/](https://github.com/reclosedev/requests-cache/tree/master/examples) folder on GitHub.
@@ -23,10 +28,10 @@
 :end-line: 4
 ```
 
-:::{admonition} Example: basic_sessions.py
+:::{admonition} Example: `basic_sessions.py`
 :class: toggle
 ```{literalinclude} ../examples/basic_sessions.py
-:lines: 1,6-
+:lines: 6-
 ```
 :::
 
@@ -36,10 +41,10 @@
 :end-line: 4
 ```
 
-:::{admonition} Example: basic_patching.py
+:::{admonition} Example: `basic_patching.py`
 :class: toggle
 ```{literalinclude} ../examples/basic_patching.py
-:lines: 1,6-
+:lines: 6-
 ```
 :::
 
@@ -49,10 +54,10 @@
 :end-line: 3
 ```
 
-:::{admonition} Example: expiration.py
+:::{admonition} Example: `expiration.py`
 :class: toggle
 ```{literalinclude} ../examples/expiration.py
-:lines: 1,5-
+:lines: 5-
 ```
 :::
 
@@ -62,10 +67,10 @@
 :end-line: 4
 ```
 
-:::{admonition} Example: /url_patterns.py
+:::{admonition} Example: `url_patterns.py`
 :class: toggle
 ```{literalinclude} ../examples/url_patterns.py
-:lines: 1,6-
+:lines: 6-
 ```
 :::
 
@@ -75,10 +80,10 @@
 :end-line: 4
 ```
 
-:::{admonition} Example: threads.py
+:::{admonition} Example: `threads.py`
 :class: toggle
 ```{literalinclude} ../examples/threads.py
-:lines: 1,6-
+:lines: 6-
 ```
 :::
 
@@ -88,10 +93,23 @@
 :end-line: 3
 ```
 
-:::{admonition} Example: log_requests.py
+:::{admonition} Example: `log_requests.py`
 :class: toggle
 ```{literalinclude} ../examples/log_requests.py
-:lines: 1,5-
+:lines: 5-
+```
+:::
+
+### External configuration
+```{include} ../examples/external_config.py
+:start-line: 2
+:end-line: 8
+```
+
+:::{admonition} Example: `external_config.py`
+:class: toggle
+```{literalinclude} ../examples/external_config.py
+:lines: 10-
 ```
 :::
 
@@ -101,10 +119,10 @@
 :end-line: 8
 ```
 
-:::{admonition} Example: benchmark.py
+:::{admonition} Example: `benchmark.py`
 :class: toggle
 ```{literalinclude} ../examples/benchmark.py
-:lines: 1,10-
+:lines: 10-
 ```
 :::
 
@@ -114,10 +132,10 @@
 :end-line: 4
 ```
 
-:::{admonition} Example: convert_cache.py
+:::{admonition} Example: `convert_cache.py`
 :class: toggle
 ```{literalinclude} ../examples/convert_cache.py
-:lines: 1,6-
+:lines: 6-
 ```
 :::
 
@@ -128,10 +146,10 @@
 :end-line: 15
 ```
 
-:::{admonition} Example: custom_request_matcher.py
+:::{admonition} Example: `custom_request_matcher.py`
 :class: toggle
 ```{literalinclude} ../examples/custom_request_matcher.py
-:lines: 1,17-
+:lines: 17-
 ```
 :::
 
@@ -142,9 +160,9 @@
 :end-line: 4
 ```
 
-:::{admonition} Example: custom_request_matcher.py
+:::{admonition} Example: `time_machine_backtesting.py`
 :class: toggle
 ```{literalinclude} ../examples/time_machine_backtesting.py
-:lines: 1,6-
+:lines: 6-
 ```
 :::
diff --git a/examples/external_config.py b/examples/external_config.py
new file mode 100644
index 0000000..0ab6508
--- /dev/null
+++ b/examples/external_config.py
@@ -0,0 +1,29 @@
+#!/usr/bin/env python
+"""
+An example of loading CachedSession settings from an external config file.
+
+Limitations:
+* Does not include backend or serializer settings
+* Does not include settings specified as python expressions, for example `timedelta` objects or
+  callback functions
+"""
+from pathlib import Path
+
+import yaml
+
+from requests_cache import CachedSession, CacheSettings
+
+CONFIG_FILE = Path(__file__).parent / 'external_config.yml'
+
+
+def load_settings() -> CacheSettings:
+    """Load settings from a YAML config file"""
+    with open(CONFIG_FILE) as f:
+        settings = yaml.safe_load(f)
+    return CacheSettings(**settings['cache_settings'])
+
+
+if __name__ == '__main__':
+    session = CachedSession()
+    session.settings = load_settings()
+    print('Loaded settings:\n', session.settings)
diff --git a/examples/external_config.yml b/examples/external_config.yml
new file mode 100644
index 0000000..ce26e29
--- /dev/null
+++ b/examples/external_config.yml
@@ -0,0 +1,16 @@
+# See external_config.py for usage example
+cache_settings:
+  expire_after: 360
+  cache_control: True
+  stale_if_error: True
+  allowable_methods:
+    - GET
+    - HEAD
+    - POST
+  allowable_codes:
+    - 200
+    - 400
+  ignored_parameters:
+    - api_key
+  match_headers:
+    - Accept-Language