diff --git a/app/cache.php b/app/cache.php
index e0f2624..c85ca32 100644
--- a/app/cache.php
+++ b/app/cache.php
@@ -1,15 +1,28 @@
 <?php
 
+function buildCacheKey(string $filePath, string $langPrefix = ''): string {
+    $mtime = filemtime($filePath);
+
+    // Include metadata.ini mtime so metadata edits invalidate cache
+    $metadataFile = dirname($filePath) . '/metadata.ini';
+    $metaMtime = file_exists($metadataFile) ? filemtime($metadataFile) : 0;
+
+    // Include global config mtime so config changes invalidate cache
+    $customConfig = __DIR__ . '/../custom/config.ini';
+    $defaultConfig = __DIR__ . '/default/config.ini';
+    $configMtime = file_exists($customConfig) ? filemtime($customConfig) : filemtime($defaultConfig);
+
+    return md5($filePath . $mtime . $metaMtime . $configMtime . $langPrefix);
+}
+
 function getCachedMarkdown(string $filePath, string $langPrefix = ''): ?string {
     $cacheDir = '/tmp/folderweb_cache';
-    $mtime = filemtime($filePath);
-    $cacheKey = md5($filePath . $mtime . $langPrefix);
-    $cachePath = "$cacheDir/$cacheKey";
-    
+    $cachePath = "$cacheDir/" . buildCacheKey($filePath, $langPrefix);
+
     if (file_exists($cachePath)) {
         return file_get_contents($cachePath);
     }
-    
+
     return null;
 }
 
@@ -18,10 +31,8 @@ function setCachedMarkdown(string $filePath, string $html, string $langPrefix =
     if (!is_dir($cacheDir)) {
         mkdir($cacheDir, 0755, true);
     }
-    
-    $mtime = filemtime($filePath);
-    $cacheKey = md5($filePath . $mtime . $langPrefix);
-    $cachePath = "$cacheDir/$cacheKey";
-    
+
+    $cachePath = "$cacheDir/" . buildCacheKey($filePath, $langPrefix);
+
     file_put_contents($cachePath, $html);
 }
diff --git a/docs/04-development/07-rendering.md b/docs/04-development/07-rendering.md
index b2b49d8..c2d1de1 100644
--- a/docs/04-development/07-rendering.md
+++ b/docs/04-development/07-rendering.md
@@ -61,12 +61,14 @@ Feed piggybacks on the existing Markdown cache — no separate feed cache needed
 
 Defined in `app/cache.php`. File-based cache in `/tmp/folderweb_cache/`.
 
-**Cache key:** `md5($filePath . $mtime . $langPrefix)`
+**Cache key:** `md5($filePath . $mtime . $metaMtime . $configMtime . $langPrefix)`
 
-- Invalidates when file is modified (mtime changes)
+- Invalidates when content file is modified (mtime changes)
+- Invalidates when `metadata.ini` in the same directory is modified
+- Invalidates when global config (`custom/config.ini` or `app/default/config.ini`) is modified
 - Invalidates per-language (different link rewriting)
 - No explicit TTL — entries persist until temp directory cleanup
-- **Does not track plugin state** — if a plugin modifies Markdown output (e.g., via PROCESS_CONTENT on files), changing plugin config won't bust the cache. Clear `/tmp/folderweb_cache/` manually after plugin changes that affect rendered Markdown.
+- **Does not track plugin state** — if a plugin modifies Markdown output (e.g., via PROCESS_CONTENT on files), changing plugin code won't bust the cache. Clear `/tmp/folderweb_cache/` manually after plugin changes that affect rendered Markdown.
 
 ```php
 getCachedMarkdown(string $filePath, string $langPrefix = ''): ?string