diff --git a/packages/guides-cli/resources/schema/guides.xsd b/packages/guides-cli/resources/schema/guides.xsd
index c25cc6f6a..1bb692b82 100644
--- a/packages/guides-cli/resources/schema/guides.xsd
+++ b/packages/guides-cli/resources/schema/guides.xsd
@@ -31,6 +31,7 @@
         <xsd:attribute name="theme" type="xsd:string"/>
         <xsd:attribute name="default-code-language" type="xsd:string"/>
         <xsd:attribute name="links-are-relative" type="xsd:string"/>
+        <xsd:attribute name="automatic-menu" type="xsd:string"/>
         <xsd:attribute name="max-menu-depth" type="xsd:int"/>
 
     </xsd:complexType>
diff --git a/packages/guides-markdown/src/Markdown/MarkupLanguageParser.php b/packages/guides-markdown/src/Markdown/MarkupLanguageParser.php
index 0a56ac918..e92b8ee1d 100644
--- a/packages/guides-markdown/src/Markdown/MarkupLanguageParser.php
+++ b/packages/guides-markdown/src/Markdown/MarkupLanguageParser.php
@@ -24,6 +24,8 @@
 use phpDocumentor\Guides\Nodes\DocumentNode;
 use phpDocumentor\Guides\Nodes\Node;
 use phpDocumentor\Guides\ParserContext;
+use phpDocumentor\Guides\Settings\ProjectSettings;
+use phpDocumentor\Guides\Settings\SettingsManager;
 use Psr\Log\LoggerInterface;
 use RuntimeException;
 
@@ -40,16 +42,21 @@ final class MarkupLanguageParser implements MarkupLanguageParserInterface
 
     private DocumentNode|null $document = null;
 
+    private SettingsManager $settingsManager;
+
     /** @param iterable<ParserInterface<Node>> $parsers */
     public function __construct(
         private readonly LoggerInterface $logger,
         private readonly iterable $parsers,
+        SettingsManager|null $settingsManager,
     ) {
         $cmEnvironment = new CommonMarkEnvironment(['html_input' => 'strip']);
         $cmEnvironment->addExtension(new CommonMarkCoreExtension());
         $cmEnvironment->addExtension(new TableExtension());
         $cmEnvironment->addExtension(new AutolinkExtension());
         $this->markdownParser = new MarkdownParser($cmEnvironment);
+        // if for backward compatibility reasons no settings manager was passed, use the defaults
+        $this->settingsManager = $settingsManager ?? new SettingsManager(new ProjectSettings());
     }
 
     public function supports(string $inputFormat): bool
@@ -69,7 +76,7 @@ public function parse(ParserContext $parserContext, string $contents): DocumentN
     private function parseDocument(NodeWalker $walker, string $hash): DocumentNode
     {
         $document = new DocumentNode($hash, ltrim($this->getParserContext()->getCurrentAbsolutePath(), '/'));
-        $document->setOrphan(true);
+        $document->setOrphan(!$this->settingsManager->getProjectSettings()->isAutomaticMenu());
         $this->document = $document;
 
         while ($event = $walker->next()) {
diff --git a/packages/guides/src/Compiler/NodeTransformers/MenuNodeTransformers/TocNodeReplacementTransformer.php b/packages/guides/src/Compiler/NodeTransformers/MenuNodeTransformers/TocNodeReplacementTransformer.php
new file mode 100644
index 000000000..0063b211d
--- /dev/null
+++ b/packages/guides/src/Compiler/NodeTransformers/MenuNodeTransformers/TocNodeReplacementTransformer.php
@@ -0,0 +1,72 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of phpDocumentor.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @link https://phpdoc.org
+ */
+
+namespace phpDocumentor\Guides\Compiler\NodeTransformers\MenuNodeTransformers;
+
+use phpDocumentor\Guides\Compiler\CompilerContextInterface;
+use phpDocumentor\Guides\Compiler\NodeTransformer;
+use phpDocumentor\Guides\Nodes\Menu\MenuNode;
+use phpDocumentor\Guides\Nodes\Menu\NavMenuNode;
+use phpDocumentor\Guides\Nodes\Menu\TocNode;
+use phpDocumentor\Guides\Nodes\Node;
+use phpDocumentor\Guides\Settings\SettingsManager;
+use Psr\Log\LoggerInterface;
+
+/** @implements NodeTransformer<MenuNode> */
+final class TocNodeReplacementTransformer implements NodeTransformer
+{
+    public function __construct(
+        private readonly LoggerInterface $logger,
+        private readonly SettingsManager $settingsManager,
+    ) {
+    }
+
+    public function enterNode(Node $node, CompilerContextInterface $compilerContext): Node
+    {
+        return $node;
+    }
+
+    public function leaveNode(Node $node, CompilerContextInterface $compilerContext): Node|null
+    {
+        if (!$node instanceof TocNode) {
+            return $node;
+        }
+
+        if (!$this->settingsManager->getProjectSettings()->isAutomaticMenu()) {
+            return $node;
+        }
+
+        if ($node->hasOption('hidden')) {
+            $this->logger->warning('The `.. toctree::` directive with option `:hidden:` is not supported in automatic-menu mode. ', $compilerContext->getLoggerInformation());
+
+            return null;
+        }
+
+        $this->logger->warning('The `.. toctree::` directive is not supported in automatic-menu mode. Use `.. menu::` instead. ', $compilerContext->getLoggerInformation());
+        $menuNode = new NavMenuNode($node->getMenuEntries());
+        $menuNode = $menuNode->withOptions($node->getOptions());
+        $menuNode = $menuNode->withCaption($node->getCaption());
+
+        return $menuNode;
+    }
+
+    public function supports(Node $node): bool
+    {
+        return $node instanceof TocNode;
+    }
+
+    public function getPriority(): int
+    {
+        return 20_000;
+    }
+}
diff --git a/packages/guides/src/Compiler/Passes/AutomaticMenuPass.php b/packages/guides/src/Compiler/Passes/AutomaticMenuPass.php
new file mode 100644
index 000000000..8dee004fd
--- /dev/null
+++ b/packages/guides/src/Compiler/Passes/AutomaticMenuPass.php
@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of phpDocumentor.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @link https://phpdoc.org
+ */
+
+namespace phpDocumentor\Guides\Compiler\Passes;
+
+use phpDocumentor\Guides\Compiler\CompilerContextInterface;
+use phpDocumentor\Guides\Compiler\CompilerPass;
+use phpDocumentor\Guides\Nodes\DocumentNode;
+use phpDocumentor\Guides\Settings\SettingsManager;
+
+final class AutomaticMenuPass implements CompilerPass
+{
+    public function __construct(
+        private readonly SettingsManager $settingsManager,
+    ) {
+    }
+
+    public function getPriority(): int
+    {
+        return 20; // must be run very late
+    }
+
+    /**
+     * @param DocumentNode[] $documents
+     *
+     * @return DocumentNode[]
+     */
+    public function run(array $documents, CompilerContextInterface $compilerContext): array
+    {
+        if (!$this->settingsManager->getProjectSettings()->isAutomaticMenu()) {
+            return $documents;
+        }
+
+        $projectNode = $compilerContext->getProjectNode();
+        $rootDocumentEntry = $projectNode->getRootDocumentEntry();
+        foreach ($documents as $documentNode) {
+            if ($documentNode->isOrphan()) {
+                // Do not add orphans to the automatic menu
+                continue;
+            }
+
+            if ($documentNode->isRoot()) {
+                continue;
+            }
+
+            $documentEntry = $projectNode->getDocumentEntry($documentNode->getFilePath());
+            $documentEntry->setParent($rootDocumentEntry);
+            $rootDocumentEntry->addChild($documentEntry);
+        }
+
+        return $documents;
+    }
+}
diff --git a/packages/guides/src/Compiler/Passes/GlobalMenuPass.php b/packages/guides/src/Compiler/Passes/GlobalMenuPass.php
index b1891d7e2..13ec50799 100644
--- a/packages/guides/src/Compiler/Passes/GlobalMenuPass.php
+++ b/packages/guides/src/Compiler/Passes/GlobalMenuPass.php
@@ -30,6 +30,7 @@
 
 use function array_map;
 use function assert;
+use function count;
 
 use const PHP_INT_MAX;
 
@@ -56,7 +57,7 @@ public function run(array $documents, CompilerContextInterface $compilerContext)
         try {
             $rootDocumentEntry = $projectNode->getRootDocumentEntry();
         } catch (Throwable) {
-            // Todo: Functional tests have not root document entry
+            // Todo: Functional tests have no root document entry
             return $documents;
         }
 
@@ -78,11 +79,27 @@ public function run(array $documents, CompilerContextInterface $compilerContext)
             $menuNodes[] = $menuNode->withCaption($tocNode->getCaption());
         }
 
+        if ($this->settingsManager->getProjectSettings()->isAutomaticMenu() && count($menuNodes) === 0) {
+            $menuNodes[] = $this->getNavMenuNodeFromDocumentEntries($compilerContext);
+        }
+
         $projectNode->setGlobalMenues($menuNodes);
 
         return $documents;
     }
 
+    private function getNavMenuNodeFromDocumentEntries(CompilerContextInterface $compilerContext): NavMenuNode
+    {
+        $menuEntries = [];
+        $rootDocumentEntry = $compilerContext->getProjectNode()->getRootDocumentEntry();
+        foreach ($rootDocumentEntry->getChildren() as $documentEntryNode) {
+            $newMenuEntry = new InternalMenuEntryNode($documentEntryNode->getFile(), $documentEntryNode->getTitle(), [], false, 1);
+            $menuEntries[] = $newMenuEntry;
+        }
+
+        return new NavMenuNode($menuEntries);
+    }
+
     private function getNavMenuNodefromTocNode(CompilerContextInterface $compilerContext, TocNode $tocNode, string|null $menuType = null): NavMenuNode
     {
         $self = $this;
diff --git a/packages/guides/src/Compiler/Passes/ToctreeValidationPass.php b/packages/guides/src/Compiler/Passes/ToctreeValidationPass.php
index 208f40e1c..75a69bb9b 100644
--- a/packages/guides/src/Compiler/Passes/ToctreeValidationPass.php
+++ b/packages/guides/src/Compiler/Passes/ToctreeValidationPass.php
@@ -18,13 +18,20 @@
 use phpDocumentor\Guides\Nodes\DocumentNode;
 use phpDocumentor\Guides\Nodes\DocumentTree\DocumentEntryNode;
 use phpDocumentor\Guides\Nodes\ProjectNode;
+use phpDocumentor\Guides\Settings\ProjectSettings;
+use phpDocumentor\Guides\Settings\SettingsManager;
 use Psr\Log\LoggerInterface;
 
 final class ToctreeValidationPass implements CompilerPass
 {
+    private SettingsManager $settingsManager;
+
     public function __construct(
         private readonly LoggerInterface $logger,
+        SettingsManager|null $settingsManager = null,
     ) {
+        // if for backward compatibility reasons no settings manager was passed, use the defaults
+        $this->settingsManager = $settingsManager ?? new SettingsManager(new ProjectSettings());
     }
 
     public function getPriority(): int
@@ -39,6 +46,10 @@ public function getPriority(): int
      */
     public function run(array $documents, CompilerContextInterface $compilerContext): array
     {
+        if ($this->settingsManager->getProjectSettings()->isAutomaticMenu()) {
+            return $documents;
+        }
+
         $projectNode = $compilerContext->getProjectNode();
 
         foreach ($documents as $document) {
diff --git a/packages/guides/src/DependencyInjection/GuidesExtension.php b/packages/guides/src/DependencyInjection/GuidesExtension.php
index 10d37c716..35a99614e 100644
--- a/packages/guides/src/DependencyInjection/GuidesExtension.php
+++ b/packages/guides/src/DependencyInjection/GuidesExtension.php
@@ -143,6 +143,7 @@ static function ($value) {
                 ->scalarNode('show_progress')->end()
                 ->scalarNode('links_are_relative')->end()
                 ->scalarNode('max_menu_depth')->end()
+                ->scalarNode('automatic_menu')->end()
                 ->arrayNode('base_template_paths')
                     ->defaultValue([])
                     ->scalarPrototype()->end()
@@ -278,6 +279,10 @@ public function load(array $configs, ContainerBuilder $container): void
             $projectSettings->setMaxMenuDepth((int) $config['max_menu_depth']);
         }
 
+        if (isset($config['automatic_menu'])) {
+            $projectSettings->setAutomaticMenu((bool) $config['automatic_menu']);
+        }
+
         if (isset($config['default_code_language'])) {
             $projectSettings->setDefaultCodeLanguage((string) $config['default_code_language']);
         }
diff --git a/packages/guides/src/Settings/ProjectSettings.php b/packages/guides/src/Settings/ProjectSettings.php
index 1256ac701..08bdfd3eb 100644
--- a/packages/guides/src/Settings/ProjectSettings.php
+++ b/packages/guides/src/Settings/ProjectSettings.php
@@ -35,6 +35,7 @@ final class ProjectSettings
     private bool $linksRelative = false;
     private string $defaultCodeLanguage = '';
     private int $maxMenuDepth = 0;
+    private bool $automaticMenu = false;
 
     /** @var string[] */
     private array $ignoredDomains = [];
@@ -243,4 +244,16 @@ public function setIndexName(string $indexName): ProjectSettings
 
         return $this;
     }
+
+    public function isAutomaticMenu(): bool
+    {
+        return $this->automaticMenu;
+    }
+
+    public function setAutomaticMenu(bool $automaticMenu): ProjectSettings
+    {
+        $this->automaticMenu = $automaticMenu;
+
+        return $this;
+    }
 }
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-default-menu/expected/anotherPage.html b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/expected/anotherPage.html
new file mode 100644
index 000000000..93be8de8b
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/expected/anotherPage.html
@@ -0,0 +1,106 @@
+<!DOCTYPE html>
+<html class="no-js" lang="en">
+<head>
+    <title>Another Page - Bootstrap Theme</title>
+    <!-- Required meta tags -->
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+        
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC" crossorigin="anonymous">
+</head>
+<body>
+<header class="">
+        
+<nav class="navbar navbar-expand-lg navbar-dark bg-primary">
+    <div class="container">
+
+        <a class="navbar-brand" href="#">Navbar</a>
+        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
+            <span class="navbar-toggler-icon"></span>
+        </button>
+        <div class="collapse navbar-collapse" id="navbarSupportedContent">
+                                
+<ul class="navbar-nav me-auto mb-2 mb-lg-0">
+    <li class="nav-item">
+            <a href="/anotherPage.html" class="nav-link current active" aria-current="page">
+                Another Page
+            </a>
+        </li><li class="nav-item">
+            <a href="/somePage.html" class="nav-link">
+                Some Page
+            </a>
+        </li><li class="nav-item">
+            <a href="/yetAnotherPage.html" class="nav-link">
+                Yet Another Page
+            </a>
+        </li></ul>
+
+                    </div>
+    </div>
+</nav>
+</header>
+<main id="main-content">
+    <div class="container">
+        <div class="container">
+            <div class="row">
+                <div class="col-lg-3">
+                                <nav class="nav flex-column">
+        <ul class="menu-level-main">
+        <li>
+            <a href="/anotherPage.html"
+               class="nav-link current active" aria-current="page">Another Page</a>
+        </li>
+        <li>
+            <a href="/somePage.html"
+               class="nav-link">Some Page</a>
+        </li>
+        <li>
+            <a href="/yetAnotherPage.html"
+               class="nav-link">Yet Another Page</a>
+        </li>
+            </ul>
+</nav>
+
+                </div>
+                <div class="col-lg-9">
+                        
+<nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+        <li class="breadcrumb-item"><a href="/index.html">Document Title</a></li>
+        <li class="breadcrumb-item"><a href="/anotherPage.html">Another Page</a></li>
+            </ol>
+</nav>
+                    <!-- content start -->
+                        
+<div class="section" id="another-page">
+            <h1>Another Page</h1>
+            
+    <p>Lorem Ipsum Dolor.</p>
+
+    </div>
+                    <!-- content end -->
+                </div>
+            </div>
+        </div>
+    </div>
+</main>
+                <footer class="bg-primary text-light">
+            <div class="container">
+                
+    <p>Generated by <a href="https://www.phpdoc.org/">phpDocumentor</a>.</p>
+
+</div>
+        </footer>
+    
+<!-- Optional JavaScript; choose one of the two! -->
+
+<!-- Option 1: Bootstrap Bundle with Popper -->
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM" crossorigin="anonymous"></script>
+
+<!-- Option 2: Separate Popper and Bootstrap JS -->
+<!--
+<script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.9.2/dist/umd/popper.min.js" integrity="sha384-IQsoLXl5PILFhosVNubq5LC7Qb9DXgDA9i+tQ8Zj3iwWAwPtgFTxbJ8NT4GN1R8p" crossorigin="anonymous"></script>
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.min.js" integrity="sha384-cVKIPhGWiC2Al4u+LWgxfKTRIcfu0JTxR+EQDz/bgldoEyl4H0zUF0QKbrJ0EcQF" crossorigin="anonymous"></script>
+-->
+</body>
+</html>
\ No newline at end of file
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-default-menu/expected/index.html b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/expected/index.html
new file mode 100644
index 000000000..a299a5880
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/expected/index.html
@@ -0,0 +1,105 @@
+<!DOCTYPE html>
+<html class="no-js" lang="en">
+<head>
+    <title>Document Title - Bootstrap Theme</title>
+    <!-- Required meta tags -->
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+        
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC" crossorigin="anonymous">
+</head>
+<body>
+<header class="">
+        
+<nav class="navbar navbar-expand-lg navbar-dark bg-primary">
+    <div class="container">
+
+        <a class="navbar-brand" href="#">Navbar</a>
+        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
+            <span class="navbar-toggler-icon"></span>
+        </button>
+        <div class="collapse navbar-collapse" id="navbarSupportedContent">
+                                
+<ul class="navbar-nav me-auto mb-2 mb-lg-0">
+    <li class="nav-item">
+            <a href="/anotherPage.html" class="nav-link">
+                Another Page
+            </a>
+        </li><li class="nav-item">
+            <a href="/somePage.html" class="nav-link">
+                Some Page
+            </a>
+        </li><li class="nav-item">
+            <a href="/yetAnotherPage.html" class="nav-link">
+                Yet Another Page
+            </a>
+        </li></ul>
+
+                    </div>
+    </div>
+</nav>
+</header>
+<main id="main-content">
+    <div class="container">
+        <div class="container">
+            <div class="row">
+                <div class="col-lg-3">
+                                <nav class="nav flex-column">
+        <ul class="menu-level-main">
+        <li>
+            <a href="/anotherPage.html"
+               class="nav-link">Another Page</a>
+        </li>
+        <li>
+            <a href="/somePage.html"
+               class="nav-link">Some Page</a>
+        </li>
+        <li>
+            <a href="/yetAnotherPage.html"
+               class="nav-link">Yet Another Page</a>
+        </li>
+            </ul>
+</nav>
+
+                </div>
+                <div class="col-lg-9">
+                        
+<nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+        <li class="breadcrumb-item"><a href="/index.html">Document Title</a></li>
+            </ol>
+</nav>
+                    <!-- content start -->
+                        
+<div class="section" id="document-title">
+            <h1>Document Title</h1>
+            
+    <p>Lorem Ipsum Dolor.</p>
+
+    </div>
+                    <!-- content end -->
+                </div>
+            </div>
+        </div>
+    </div>
+</main>
+                <footer class="bg-primary text-light">
+            <div class="container">
+                
+    <p>Generated by <a href="https://www.phpdoc.org/">phpDocumentor</a>.</p>
+
+</div>
+        </footer>
+    
+<!-- Optional JavaScript; choose one of the two! -->
+
+<!-- Option 1: Bootstrap Bundle with Popper -->
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM" crossorigin="anonymous"></script>
+
+<!-- Option 2: Separate Popper and Bootstrap JS -->
+<!--
+<script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.9.2/dist/umd/popper.min.js" integrity="sha384-IQsoLXl5PILFhosVNubq5LC7Qb9DXgDA9i+tQ8Zj3iwWAwPtgFTxbJ8NT4GN1R8p" crossorigin="anonymous"></script>
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.min.js" integrity="sha384-cVKIPhGWiC2Al4u+LWgxfKTRIcfu0JTxR+EQDz/bgldoEyl4H0zUF0QKbrJ0EcQF" crossorigin="anonymous"></script>
+-->
+</body>
+</html>
\ No newline at end of file
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-default-menu/expected/somePage.html b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/expected/somePage.html
new file mode 100644
index 000000000..f1a9212c3
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/expected/somePage.html
@@ -0,0 +1,106 @@
+<!DOCTYPE html>
+<html class="no-js" lang="en">
+<head>
+    <title>Some Page - Bootstrap Theme</title>
+    <!-- Required meta tags -->
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+        
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC" crossorigin="anonymous">
+</head>
+<body>
+<header class="">
+        
+<nav class="navbar navbar-expand-lg navbar-dark bg-primary">
+    <div class="container">
+
+        <a class="navbar-brand" href="#">Navbar</a>
+        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
+            <span class="navbar-toggler-icon"></span>
+        </button>
+        <div class="collapse navbar-collapse" id="navbarSupportedContent">
+                                
+<ul class="navbar-nav me-auto mb-2 mb-lg-0">
+    <li class="nav-item">
+            <a href="/anotherPage.html" class="nav-link">
+                Another Page
+            </a>
+        </li><li class="nav-item">
+            <a href="/somePage.html" class="nav-link current active" aria-current="page">
+                Some Page
+            </a>
+        </li><li class="nav-item">
+            <a href="/yetAnotherPage.html" class="nav-link">
+                Yet Another Page
+            </a>
+        </li></ul>
+
+                    </div>
+    </div>
+</nav>
+</header>
+<main id="main-content">
+    <div class="container">
+        <div class="container">
+            <div class="row">
+                <div class="col-lg-3">
+                                <nav class="nav flex-column">
+        <ul class="menu-level-main">
+        <li>
+            <a href="/anotherPage.html"
+               class="nav-link">Another Page</a>
+        </li>
+        <li>
+            <a href="/somePage.html"
+               class="nav-link current active" aria-current="page">Some Page</a>
+        </li>
+        <li>
+            <a href="/yetAnotherPage.html"
+               class="nav-link">Yet Another Page</a>
+        </li>
+            </ul>
+</nav>
+
+                </div>
+                <div class="col-lg-9">
+                        
+<nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+        <li class="breadcrumb-item"><a href="/index.html">Document Title</a></li>
+        <li class="breadcrumb-item"><a href="/somePage.html">Some Page</a></li>
+            </ol>
+</nav>
+                    <!-- content start -->
+                        
+<div class="section" id="some-page">
+            <h1>Some Page</h1>
+            
+    <p>Lorem Ipsum <span class="custom">Dolor</span>.</p>
+
+    </div>
+                    <!-- content end -->
+                </div>
+            </div>
+        </div>
+    </div>
+</main>
+                <footer class="bg-primary text-light">
+            <div class="container">
+                
+    <p>Generated by <a href="https://www.phpdoc.org/">phpDocumentor</a>.</p>
+
+</div>
+        </footer>
+    
+<!-- Optional JavaScript; choose one of the two! -->
+
+<!-- Option 1: Bootstrap Bundle with Popper -->
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM" crossorigin="anonymous"></script>
+
+<!-- Option 2: Separate Popper and Bootstrap JS -->
+<!--
+<script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.9.2/dist/umd/popper.min.js" integrity="sha384-IQsoLXl5PILFhosVNubq5LC7Qb9DXgDA9i+tQ8Zj3iwWAwPtgFTxbJ8NT4GN1R8p" crossorigin="anonymous"></script>
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.min.js" integrity="sha384-cVKIPhGWiC2Al4u+LWgxfKTRIcfu0JTxR+EQDz/bgldoEyl4H0zUF0QKbrJ0EcQF" crossorigin="anonymous"></script>
+-->
+</body>
+</html>
\ No newline at end of file
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/anotherPage.rst b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/anotherPage.rst
new file mode 100644
index 000000000..5e259c9eb
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/anotherPage.rst
@@ -0,0 +1,7 @@
+..  include:: /include.rst.txt
+
+============
+Another Page
+============
+
+Lorem Ipsum Dolor.
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/guides.xml b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/guides.xml
new file mode 100644
index 000000000..8fa6367e8
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/guides.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<guides xmlns="https://www.phpdoc.org/guides"
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:schemaLocation="https://www.phpdoc.org/guides packages/guides-cli/resources/schema/guides.xsd"
+        theme="bootstrap"
+        automatic-menu="true"
+>
+    <extension class="phpDocumentor\Guides\Bootstrap"/>
+</guides>
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/include.rst.txt b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/include.rst.txt
new file mode 100644
index 000000000..c234e39bb
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/include.rst.txt
@@ -0,0 +1,6 @@
+..  documentblock::
+    :identifier: footer
+
+    Generated by `phpDocumentor <https://www.phpdoc.org/>`__.
+
+.. role:: custom
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/index.rst b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/index.rst
new file mode 100644
index 000000000..d4ef8f2de
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/index.rst
@@ -0,0 +1,12 @@
+..  include:: /include.rst.txt
+
+:project:
+    Bootstrap Theme
+:version:
+    1.0
+
+==============
+Document Title
+==============
+
+Lorem Ipsum Dolor.
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/somePage.rst b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/somePage.rst
new file mode 100644
index 000000000..dfdf1d25d
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/somePage.rst
@@ -0,0 +1,7 @@
+..  include:: /include.rst.txt
+
+=========
+Some Page
+=========
+
+Lorem Ipsum :custom:`Dolor`.
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/yetAnotherPage.rst b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/yetAnotherPage.rst
new file mode 100644
index 000000000..1974cd413
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-default-menu/input/yetAnotherPage.rst
@@ -0,0 +1,7 @@
+..  include:: /include.rst.txt
+
+================
+Yet Another Page
+================
+
+Lorem Ipsum Dolor.
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/expected/anotherPage.html b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/expected/anotherPage.html
new file mode 100644
index 000000000..93be8de8b
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/expected/anotherPage.html
@@ -0,0 +1,106 @@
+<!DOCTYPE html>
+<html class="no-js" lang="en">
+<head>
+    <title>Another Page - Bootstrap Theme</title>
+    <!-- Required meta tags -->
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+        
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC" crossorigin="anonymous">
+</head>
+<body>
+<header class="">
+        
+<nav class="navbar navbar-expand-lg navbar-dark bg-primary">
+    <div class="container">
+
+        <a class="navbar-brand" href="#">Navbar</a>
+        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
+            <span class="navbar-toggler-icon"></span>
+        </button>
+        <div class="collapse navbar-collapse" id="navbarSupportedContent">
+                                
+<ul class="navbar-nav me-auto mb-2 mb-lg-0">
+    <li class="nav-item">
+            <a href="/anotherPage.html" class="nav-link current active" aria-current="page">
+                Another Page
+            </a>
+        </li><li class="nav-item">
+            <a href="/somePage.html" class="nav-link">
+                Some Page
+            </a>
+        </li><li class="nav-item">
+            <a href="/yetAnotherPage.html" class="nav-link">
+                Yet Another Page
+            </a>
+        </li></ul>
+
+                    </div>
+    </div>
+</nav>
+</header>
+<main id="main-content">
+    <div class="container">
+        <div class="container">
+            <div class="row">
+                <div class="col-lg-3">
+                                <nav class="nav flex-column">
+        <ul class="menu-level-main">
+        <li>
+            <a href="/anotherPage.html"
+               class="nav-link current active" aria-current="page">Another Page</a>
+        </li>
+        <li>
+            <a href="/somePage.html"
+               class="nav-link">Some Page</a>
+        </li>
+        <li>
+            <a href="/yetAnotherPage.html"
+               class="nav-link">Yet Another Page</a>
+        </li>
+            </ul>
+</nav>
+
+                </div>
+                <div class="col-lg-9">
+                        
+<nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+        <li class="breadcrumb-item"><a href="/index.html">Document Title</a></li>
+        <li class="breadcrumb-item"><a href="/anotherPage.html">Another Page</a></li>
+            </ol>
+</nav>
+                    <!-- content start -->
+                        
+<div class="section" id="another-page">
+            <h1>Another Page</h1>
+            
+    <p>Lorem Ipsum Dolor.</p>
+
+    </div>
+                    <!-- content end -->
+                </div>
+            </div>
+        </div>
+    </div>
+</main>
+                <footer class="bg-primary text-light">
+            <div class="container">
+                
+    <p>Generated by <a href="https://www.phpdoc.org/">phpDocumentor</a>.</p>
+
+</div>
+        </footer>
+    
+<!-- Optional JavaScript; choose one of the two! -->
+
+<!-- Option 1: Bootstrap Bundle with Popper -->
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM" crossorigin="anonymous"></script>
+
+<!-- Option 2: Separate Popper and Bootstrap JS -->
+<!--
+<script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.9.2/dist/umd/popper.min.js" integrity="sha384-IQsoLXl5PILFhosVNubq5LC7Qb9DXgDA9i+tQ8Zj3iwWAwPtgFTxbJ8NT4GN1R8p" crossorigin="anonymous"></script>
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.min.js" integrity="sha384-cVKIPhGWiC2Al4u+LWgxfKTRIcfu0JTxR+EQDz/bgldoEyl4H0zUF0QKbrJ0EcQF" crossorigin="anonymous"></script>
+-->
+</body>
+</html>
\ No newline at end of file
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/expected/index.html b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/expected/index.html
new file mode 100644
index 000000000..ed6c360bc
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/expected/index.html
@@ -0,0 +1,123 @@
+<!DOCTYPE html>
+<html class="no-js" lang="en">
+<head>
+    <title>Document Title - Bootstrap Theme</title>
+    <!-- Required meta tags -->
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+        
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC" crossorigin="anonymous">
+</head>
+<body>
+<header class="">
+        
+<nav class="navbar navbar-expand-lg navbar-dark bg-primary">
+    <div class="container">
+
+        <a class="navbar-brand" href="#">Navbar</a>
+        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
+            <span class="navbar-toggler-icon"></span>
+        </button>
+        <div class="collapse navbar-collapse" id="navbarSupportedContent">
+                                
+<ul class="navbar-nav me-auto mb-2 mb-lg-0">
+    <li class="nav-item">
+            <a href="/anotherPage.html" class="nav-link">
+                Another Page
+            </a>
+        </li><li class="nav-item">
+            <a href="/somePage.html" class="nav-link">
+                Some Page
+            </a>
+        </li><li class="nav-item">
+            <a href="/yetAnotherPage.html" class="nav-link">
+                Yet Another Page
+            </a>
+        </li></ul>
+
+                    </div>
+    </div>
+</nav>
+</header>
+<main id="main-content">
+    <div class="container">
+        <div class="container">
+            <div class="row">
+                <div class="col-lg-3">
+                                <nav class="nav flex-column">
+        <ul class="menu-level-main">
+        <li>
+            <a href="/anotherPage.html"
+               class="nav-link">Another Page</a>
+        </li>
+        <li>
+            <a href="/somePage.html"
+               class="nav-link">Some Page</a>
+        </li>
+        <li>
+            <a href="/yetAnotherPage.html"
+               class="nav-link">Yet Another Page</a>
+        </li>
+            </ul>
+</nav>
+
+                </div>
+                <div class="col-lg-9">
+                        
+<nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+        <li class="breadcrumb-item"><a href="/index.html">Document Title</a></li>
+            </ol>
+</nav>
+                    <!-- content start -->
+                        
+<div class="section" id="document-title">
+            <h1>Document Title</h1>
+            
+    <p>Lorem Ipsum Dolor.</p>
+
+            <div class="toc">
+    <li class="toc-item">
+    <a href="/yetAnotherPage.html#yet-another-page">Yet Another Page</a>
+
+
+</li>
+    <li class="toc-item">
+    <a href="/somePage.html#some-page">Some Page</a>
+
+
+</li>
+    <li class="toc-item">
+    <a href="/anotherPage.html#another-page">Another Page</a>
+
+
+</li>
+    </div>
+
+    </div>
+                    <!-- content end -->
+                </div>
+            </div>
+        </div>
+    </div>
+</main>
+                <footer class="bg-primary text-light">
+            <div class="container">
+                
+    <p>Generated by <a href="https://www.phpdoc.org/">phpDocumentor</a>.</p>
+
+</div>
+        </footer>
+    
+<!-- Optional JavaScript; choose one of the two! -->
+
+<!-- Option 1: Bootstrap Bundle with Popper -->
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM" crossorigin="anonymous"></script>
+
+<!-- Option 2: Separate Popper and Bootstrap JS -->
+<!--
+<script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.9.2/dist/umd/popper.min.js" integrity="sha384-IQsoLXl5PILFhosVNubq5LC7Qb9DXgDA9i+tQ8Zj3iwWAwPtgFTxbJ8NT4GN1R8p" crossorigin="anonymous"></script>
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.min.js" integrity="sha384-cVKIPhGWiC2Al4u+LWgxfKTRIcfu0JTxR+EQDz/bgldoEyl4H0zUF0QKbrJ0EcQF" crossorigin="anonymous"></script>
+-->
+</body>
+</html>
\ No newline at end of file
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/expected/logs/warning.log b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/expected/logs/warning.log
new file mode 100644
index 000000000..5469c2e2f
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/expected/logs/warning.log
@@ -0,0 +1 @@
+app.WARNING: The `.. toctree::` directive is not supported in automatic-menu mode. Use `.. menu::` instead.
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/expected/somePage.html b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/expected/somePage.html
new file mode 100644
index 000000000..f1a9212c3
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/expected/somePage.html
@@ -0,0 +1,106 @@
+<!DOCTYPE html>
+<html class="no-js" lang="en">
+<head>
+    <title>Some Page - Bootstrap Theme</title>
+    <!-- Required meta tags -->
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+        
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC" crossorigin="anonymous">
+</head>
+<body>
+<header class="">
+        
+<nav class="navbar navbar-expand-lg navbar-dark bg-primary">
+    <div class="container">
+
+        <a class="navbar-brand" href="#">Navbar</a>
+        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
+            <span class="navbar-toggler-icon"></span>
+        </button>
+        <div class="collapse navbar-collapse" id="navbarSupportedContent">
+                                
+<ul class="navbar-nav me-auto mb-2 mb-lg-0">
+    <li class="nav-item">
+            <a href="/anotherPage.html" class="nav-link">
+                Another Page
+            </a>
+        </li><li class="nav-item">
+            <a href="/somePage.html" class="nav-link current active" aria-current="page">
+                Some Page
+            </a>
+        </li><li class="nav-item">
+            <a href="/yetAnotherPage.html" class="nav-link">
+                Yet Another Page
+            </a>
+        </li></ul>
+
+                    </div>
+    </div>
+</nav>
+</header>
+<main id="main-content">
+    <div class="container">
+        <div class="container">
+            <div class="row">
+                <div class="col-lg-3">
+                                <nav class="nav flex-column">
+        <ul class="menu-level-main">
+        <li>
+            <a href="/anotherPage.html"
+               class="nav-link">Another Page</a>
+        </li>
+        <li>
+            <a href="/somePage.html"
+               class="nav-link current active" aria-current="page">Some Page</a>
+        </li>
+        <li>
+            <a href="/yetAnotherPage.html"
+               class="nav-link">Yet Another Page</a>
+        </li>
+            </ul>
+</nav>
+
+                </div>
+                <div class="col-lg-9">
+                        
+<nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+        <li class="breadcrumb-item"><a href="/index.html">Document Title</a></li>
+        <li class="breadcrumb-item"><a href="/somePage.html">Some Page</a></li>
+            </ol>
+</nav>
+                    <!-- content start -->
+                        
+<div class="section" id="some-page">
+            <h1>Some Page</h1>
+            
+    <p>Lorem Ipsum <span class="custom">Dolor</span>.</p>
+
+    </div>
+                    <!-- content end -->
+                </div>
+            </div>
+        </div>
+    </div>
+</main>
+                <footer class="bg-primary text-light">
+            <div class="container">
+                
+    <p>Generated by <a href="https://www.phpdoc.org/">phpDocumentor</a>.</p>
+
+</div>
+        </footer>
+    
+<!-- Optional JavaScript; choose one of the two! -->
+
+<!-- Option 1: Bootstrap Bundle with Popper -->
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM" crossorigin="anonymous"></script>
+
+<!-- Option 2: Separate Popper and Bootstrap JS -->
+<!--
+<script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.9.2/dist/umd/popper.min.js" integrity="sha384-IQsoLXl5PILFhosVNubq5LC7Qb9DXgDA9i+tQ8Zj3iwWAwPtgFTxbJ8NT4GN1R8p" crossorigin="anonymous"></script>
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.min.js" integrity="sha384-cVKIPhGWiC2Al4u+LWgxfKTRIcfu0JTxR+EQDz/bgldoEyl4H0zUF0QKbrJ0EcQF" crossorigin="anonymous"></script>
+-->
+</body>
+</html>
\ No newline at end of file
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/anotherPage.rst b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/anotherPage.rst
new file mode 100644
index 000000000..5e259c9eb
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/anotherPage.rst
@@ -0,0 +1,7 @@
+..  include:: /include.rst.txt
+
+============
+Another Page
+============
+
+Lorem Ipsum Dolor.
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/guides.xml b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/guides.xml
new file mode 100644
index 000000000..8fa6367e8
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/guides.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<guides xmlns="https://www.phpdoc.org/guides"
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:schemaLocation="https://www.phpdoc.org/guides packages/guides-cli/resources/schema/guides.xsd"
+        theme="bootstrap"
+        automatic-menu="true"
+>
+    <extension class="phpDocumentor\Guides\Bootstrap"/>
+</guides>
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/include.rst.txt b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/include.rst.txt
new file mode 100644
index 000000000..c234e39bb
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/include.rst.txt
@@ -0,0 +1,6 @@
+..  documentblock::
+    :identifier: footer
+
+    Generated by `phpDocumentor <https://www.phpdoc.org/>`__.
+
+.. role:: custom
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/index.rst b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/index.rst
new file mode 100644
index 000000000..980a3d690
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/index.rst
@@ -0,0 +1,18 @@
+..  include:: /include.rst.txt
+
+:project:
+    Bootstrap Theme
+:version:
+    1.0
+
+==============
+Document Title
+==============
+
+Lorem Ipsum Dolor.
+
+..  toctree::
+
+    yetAnotherPage
+    somePage
+    anotherPage
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/somePage.rst b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/somePage.rst
new file mode 100644
index 000000000..dfdf1d25d
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/somePage.rst
@@ -0,0 +1,7 @@
+..  include:: /include.rst.txt
+
+=========
+Some Page
+=========
+
+Lorem Ipsum :custom:`Dolor`.
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/yetAnotherPage.rst b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/yetAnotherPage.rst
new file mode 100644
index 000000000..1974cd413
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-menu-toctree/input/yetAnotherPage.rst
@@ -0,0 +1,7 @@
+..  include:: /include.rst.txt
+
+================
+Yet Another Page
+================
+
+Lorem Ipsum Dolor.
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/expected/index.html b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/expected/index.html
new file mode 100644
index 000000000..407d880ed
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/expected/index.html
@@ -0,0 +1,144 @@
+<!DOCTYPE html>
+<html class="no-js" lang="en">
+<head>
+    <title>Document Title - Bootstrap Theme</title>
+    <!-- Required meta tags -->
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+        
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC" crossorigin="anonymous">
+</head>
+<body>
+<header class="">
+        
+<nav class="navbar navbar-expand-lg navbar-dark bg-primary">
+    <div class="container">
+
+        <a class="navbar-brand" href="#">Navbar</a>
+        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
+            <span class="navbar-toggler-icon"></span>
+        </button>
+        <div class="collapse navbar-collapse" id="navbarSupportedContent">
+                                
+<ul class="navbar-nav me-auto mb-2 mb-lg-0">
+    <li class="nav-item">
+            <a href="someDirectory/index.html" class="nav-link">
+                Some Page
+            </a>
+        </li>            
+<ul class="level-">
+    <li class="nav-item">
+        <a href="someDirectory/index.html"
+           class="nav-link">Some Page</a>
+    </li>
+</ul>
+</ul>
+
+                    </div>
+    </div>
+</nav>
+</header>
+<main id="main-content">
+    <div class="container">
+        <div class="container">
+            <div class="row">
+                <div class="col-lg-3">
+                                <nav class="nav flex-column">
+        <ul class="menu-level-main">
+        <li>
+            <a href="someDirectory/index.html"
+               class="nav-link">Some Page</a>                
+<ul class="level-1">
+    <li>
+            <a href="someDirectory/anotherDirectory/index.html"
+               class="nav-link">Another Page</a>                    
+<ul class="level-2">
+    <li>
+            <a href="someDirectory/anotherDirectory/yetAnotherDirectory/index.html"
+               class="nav-link">Yet Another Page</a>                    
+<ul class="level-3">
+    <li>
+            <a href="someDirectory/anotherDirectory/yetAnotherDirectory/andYetAnotherDirectory/index.html"
+               class="nav-link">And Yet Another Page</a>
+        </li>
+    </ul>
+
+        </li>
+    </ul>
+
+        </li>
+    </ul>
+
+        </li>
+            </ul>
+</nav>
+
+                </div>
+                <div class="col-lg-9">
+                        
+<nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+        <li class="breadcrumb-item"><a href="#">Document Title</a></li>
+            </ol>
+</nav>
+                    <!-- content start -->
+                        
+<div class="section" id="document-title">
+            <h1>Document Title</h1>
+            
+    <p>Lorem Ipsum Dolor.</p>
+
+            <div class="toc">
+    <ul class="menu-level">
+    <li class="toc-item">
+    <a href="someDirectory/index.html#some-page">Some Page</a>
+        <ul class="menu-level-1">
+            <li class="toc-item">
+    <a href="someDirectory/anotherDirectory/index.html#another-page">Another Page</a>
+        <ul class="menu-level-2">
+            <li class="toc-item">
+    <a href="someDirectory/anotherDirectory/yetAnotherDirectory/index.html#yet-another-page">Yet Another Page</a>
+        <ul class="menu-level-3">
+            <li class="toc-item">
+    <a href="someDirectory/anotherDirectory/yetAnotherDirectory/andYetAnotherDirectory/index.html#and-yet-another-page">And Yet Another Page</a>
+
+
+</li>
+                    </ul>
+
+</li>
+                    </ul>
+
+</li>
+                    </ul>
+
+</li>
+    </ul>
+</div>
+    </div>
+                    <!-- content end -->
+                </div>
+            </div>
+        </div>
+    </div>
+</main>
+                <footer class="bg-primary text-light">
+            <div class="container">
+                
+    <p>Generated by <a href="https://www.phpdoc.org/">phpDocumentor</a>.</p>
+
+</div>
+        </footer>
+    
+<!-- Optional JavaScript; choose one of the two! -->
+
+<!-- Option 1: Bootstrap Bundle with Popper -->
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM" crossorigin="anonymous"></script>
+
+<!-- Option 2: Separate Popper and Bootstrap JS -->
+<!--
+<script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.9.2/dist/umd/popper.min.js" integrity="sha384-IQsoLXl5PILFhosVNubq5LC7Qb9DXgDA9i+tQ8Zj3iwWAwPtgFTxbJ8NT4GN1R8p" crossorigin="anonymous"></script>
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.min.js" integrity="sha384-cVKIPhGWiC2Al4u+LWgxfKTRIcfu0JTxR+EQDz/bgldoEyl4H0zUF0QKbrJ0EcQF" crossorigin="anonymous"></script>
+-->
+</body>
+</html>
\ No newline at end of file
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/guides.xml b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/guides.xml
new file mode 100644
index 000000000..e8d8fc319
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/guides.xml
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<guides xmlns="https://www.phpdoc.org/guides"
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:schemaLocation="https://www.phpdoc.org/guides packages/guides-cli/resources/schema/guides.xsd"
+        theme="bootstrap"
+        links-are-relative="true"
+        automatic-menu="true"
+>
+    <extension class="phpDocumentor\Guides\Bootstrap"/>
+</guides>
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/include.rst.txt b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/include.rst.txt
new file mode 100644
index 000000000..c234e39bb
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/include.rst.txt
@@ -0,0 +1,6 @@
+..  documentblock::
+    :identifier: footer
+
+    Generated by `phpDocumentor <https://www.phpdoc.org/>`__.
+
+.. role:: custom
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/index.rst b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/index.rst
new file mode 100644
index 000000000..d4ef8f2de
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/index.rst
@@ -0,0 +1,12 @@
+..  include:: /include.rst.txt
+
+:project:
+    Bootstrap Theme
+:version:
+    1.0
+
+==============
+Document Title
+==============
+
+Lorem Ipsum Dolor.
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/skip b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/skip
new file mode 100644
index 000000000..95484cd4d
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/skip
@@ -0,0 +1 @@
+Nested autocreated menus are not yet supported
\ No newline at end of file
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/someDirectory/anotherDirectory/index.rst b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/someDirectory/anotherDirectory/index.rst
new file mode 100644
index 000000000..5e259c9eb
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/someDirectory/anotherDirectory/index.rst
@@ -0,0 +1,7 @@
+..  include:: /include.rst.txt
+
+============
+Another Page
+============
+
+Lorem Ipsum Dolor.
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/someDirectory/anotherDirectory/yetAnotherDirectory/andYetAnotherDirectory/index.rst b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/someDirectory/anotherDirectory/yetAnotherDirectory/andYetAnotherDirectory/index.rst
new file mode 100644
index 000000000..e9be01f04
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/someDirectory/anotherDirectory/yetAnotherDirectory/andYetAnotherDirectory/index.rst
@@ -0,0 +1,7 @@
+..  include:: /include.rst.txt
+
+====================
+And Yet Another Page
+====================
+
+Lorem Ipsum Dolor.
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/someDirectory/anotherDirectory/yetAnotherDirectory/index.rst b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/someDirectory/anotherDirectory/yetAnotherDirectory/index.rst
new file mode 100644
index 000000000..1974cd413
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/someDirectory/anotherDirectory/yetAnotherDirectory/index.rst
@@ -0,0 +1,7 @@
+..  include:: /include.rst.txt
+
+================
+Yet Another Page
+================
+
+Lorem Ipsum Dolor.
diff --git a/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/someDirectory/index.rst b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/someDirectory/index.rst
new file mode 100644
index 000000000..dfdf1d25d
--- /dev/null
+++ b/tests/Integration/tests-full/automatic_menu/automatic-multilevel-menu/input/someDirectory/index.rst
@@ -0,0 +1,7 @@
+..  include:: /include.rst.txt
+
+=========
+Some Page
+=========
+
+Lorem Ipsum :custom:`Dolor`.
diff --git a/tests/Integration/tests-full/markdown-full/default-menu-md/expected/anotherPage.html b/tests/Integration/tests-full/markdown-full/default-menu-md/expected/anotherPage.html
index 40a7095c2..c7a3a2511 100644
--- a/tests/Integration/tests-full/markdown-full/default-menu-md/expected/anotherPage.html
+++ b/tests/Integration/tests-full/markdown-full/default-menu-md/expected/anotherPage.html
@@ -19,7 +19,22 @@
             <span class="navbar-toggler-icon"></span>
         </button>
         <div class="collapse navbar-collapse" id="navbarSupportedContent">
-                            
+                                
+<ul class="navbar-nav me-auto mb-2 mb-lg-0">
+    <li class="nav-item">
+            <a href="#" class="nav-link current active" aria-current="page">
+                Another Page
+            </a>
+        </li><li class="nav-item">
+            <a href="somePage.html" class="nav-link">
+                Some Page
+            </a>
+        </li><li class="nav-item">
+            <a href="yetAnotherPage.html" class="nav-link">
+                Yet Another Page
+            </a>
+        </li></ul>
+
                     </div>
     </div>
 </nav>
@@ -29,7 +44,23 @@
         <div class="container">
             <div class="row">
                 <div class="col-lg-3">
-                            
+                                <nav class="nav flex-column">
+        <ul class="menu-level-main">
+        <li>
+            <a href="#"
+               class="nav-link current active" aria-current="page">Another Page</a>
+        </li>
+        <li>
+            <a href="somePage.html"
+               class="nav-link">Some Page</a>
+        </li>
+        <li>
+            <a href="yetAnotherPage.html"
+               class="nav-link">Yet Another Page</a>
+        </li>
+            </ul>
+</nav>
+
                 </div>
                 <div class="col-lg-9">
                         
diff --git a/tests/Integration/tests-full/markdown-full/default-menu-md/expected/index.html b/tests/Integration/tests-full/markdown-full/default-menu-md/expected/index.html
index eb4e8ef2e..3d78ead15 100644
--- a/tests/Integration/tests-full/markdown-full/default-menu-md/expected/index.html
+++ b/tests/Integration/tests-full/markdown-full/default-menu-md/expected/index.html
@@ -19,7 +19,22 @@
             <span class="navbar-toggler-icon"></span>
         </button>
         <div class="collapse navbar-collapse" id="navbarSupportedContent">
-                            
+                                
+<ul class="navbar-nav me-auto mb-2 mb-lg-0">
+    <li class="nav-item">
+            <a href="anotherPage.html" class="nav-link">
+                Another Page
+            </a>
+        </li><li class="nav-item">
+            <a href="somePage.html" class="nav-link">
+                Some Page
+            </a>
+        </li><li class="nav-item">
+            <a href="yetAnotherPage.html" class="nav-link">
+                Yet Another Page
+            </a>
+        </li></ul>
+
                     </div>
     </div>
 </nav>
@@ -29,7 +44,23 @@
         <div class="container">
             <div class="row">
                 <div class="col-lg-3">
-                            
+                                <nav class="nav flex-column">
+        <ul class="menu-level-main">
+        <li>
+            <a href="anotherPage.html"
+               class="nav-link">Another Page</a>
+        </li>
+        <li>
+            <a href="somePage.html"
+               class="nav-link">Some Page</a>
+        </li>
+        <li>
+            <a href="yetAnotherPage.html"
+               class="nav-link">Yet Another Page</a>
+        </li>
+            </ul>
+</nav>
+
                 </div>
                 <div class="col-lg-9">
                         
diff --git a/tests/Integration/tests-full/markdown-full/default-menu-md/expected/somePage.html b/tests/Integration/tests-full/markdown-full/default-menu-md/expected/somePage.html
index 3fa4bdf7b..500644779 100644
--- a/tests/Integration/tests-full/markdown-full/default-menu-md/expected/somePage.html
+++ b/tests/Integration/tests-full/markdown-full/default-menu-md/expected/somePage.html
@@ -19,7 +19,22 @@
             <span class="navbar-toggler-icon"></span>
         </button>
         <div class="collapse navbar-collapse" id="navbarSupportedContent">
-                            
+                                
+<ul class="navbar-nav me-auto mb-2 mb-lg-0">
+    <li class="nav-item">
+            <a href="anotherPage.html" class="nav-link">
+                Another Page
+            </a>
+        </li><li class="nav-item">
+            <a href="#" class="nav-link current active" aria-current="page">
+                Some Page
+            </a>
+        </li><li class="nav-item">
+            <a href="yetAnotherPage.html" class="nav-link">
+                Yet Another Page
+            </a>
+        </li></ul>
+
                     </div>
     </div>
 </nav>
@@ -29,7 +44,23 @@
         <div class="container">
             <div class="row">
                 <div class="col-lg-3">
-                            
+                                <nav class="nav flex-column">
+        <ul class="menu-level-main">
+        <li>
+            <a href="anotherPage.html"
+               class="nav-link">Another Page</a>
+        </li>
+        <li>
+            <a href="#"
+               class="nav-link current active" aria-current="page">Some Page</a>
+        </li>
+        <li>
+            <a href="yetAnotherPage.html"
+               class="nav-link">Yet Another Page</a>
+        </li>
+            </ul>
+</nav>
+
                 </div>
                 <div class="col-lg-9">
                         
diff --git a/tests/Integration/tests-full/markdown-full/default-menu-md/input/guides.xml b/tests/Integration/tests-full/markdown-full/default-menu-md/input/guides.xml
index 280ec62fe..4759d605e 100644
--- a/tests/Integration/tests-full/markdown-full/default-menu-md/input/guides.xml
+++ b/tests/Integration/tests-full/markdown-full/default-menu-md/input/guides.xml
@@ -5,6 +5,7 @@
         theme="bootstrap"
         input-format="md"
         links-are-relative="1"
+        automatic-menu="true"
 >
     <extension class="phpDocumentor\Guides\Bootstrap"/>
 </guides>
diff --git a/tests/Integration/tests-full/markdown-full/nested-menu-md/expected/dir2/index.html b/tests/Integration/tests-full/markdown-full/nested-menu-md/expected/dir2/index.html
new file mode 100644
index 000000000..30dfc3d5e
--- /dev/null
+++ b/tests/Integration/tests-full/markdown-full/nested-menu-md/expected/dir2/index.html
@@ -0,0 +1,121 @@
+<!DOCTYPE html>
+<html class="no-js" lang="en">
+<head>
+    <title>Dir 2 Title</title>
+    <!-- Required meta tags -->
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+        
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC" crossorigin="anonymous">
+</head>
+<body>
+<header class="">
+        
+<nav class="navbar navbar-expand-lg navbar-dark bg-primary">
+    <div class="container">
+
+        <a class="navbar-brand" href="#">Navbar</a>
+        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
+            <span class="navbar-toggler-icon"></span>
+        </button>
+        <div class="collapse navbar-collapse" id="navbarSupportedContent">
+                                
+<ul class="navbar-nav me-auto mb-2 mb-lg-0">
+    <li class="nav-item">
+            <a href="../anotherPage.html" class="nav-link">
+                Another Page
+            </a>
+        </li><li class="nav-item">
+            <a href="../dir1/index.html" class="nav-link">
+                Dir 1 Title
+            </a>
+        </li><li class="nav-item">
+            <a href="#" class="nav-link current active" aria-current="page">
+                Dir 2 Title
+            </a>
+        </li><li class="nav-item">
+            <a href="../somePage.html" class="nav-link">
+                Some Page
+            </a>
+        </li><li class="nav-item">
+            <a href="../yetAnotherPage.html" class="nav-link">
+                Yet Another Page
+            </a>
+        </li></ul>
+
+                    </div>
+    </div>
+</nav>
+</header>
+<main id="main-content">
+    <div class="container">
+        <div class="container">
+            <div class="row">
+                <div class="col-lg-3">
+                                <nav class="nav flex-column">
+        <ul class="menu-level-main">
+        <li>
+            <a href="../anotherPage.html"
+               class="nav-link">Another Page</a>
+        </li>
+        <li>
+            <a href="../dir1/index.html"
+               class="nav-link">Dir 1 Title</a>
+        </li>
+        <li>
+            <a href="#"
+               class="nav-link current active" aria-current="page">Dir 2 Title</a>
+            <ul>
+                <li>
+                    <a href="somePage.html"
+                       class="nav-link">Some Page in dir 2</a>
+                </li>
+            </ul>
+        </li>
+
+        <li>
+            <a href="../somePage.html"
+               class="nav-link">Some Page</a>
+        </li>
+        <li>
+            <a href="../yetAnotherPage.html"
+               class="nav-link">Yet Another Page</a>
+        </li>
+            </ul>
+</nav>
+
+                </div>
+                <div class="col-lg-9">
+                        
+<nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+        <li class="breadcrumb-item"><a href="../index.html">Document Title</a></li>
+        <li class="breadcrumb-item"><a href="#">Dir 2 Title</a></li>
+            </ol>
+</nav>
+                    <!-- content start -->
+                        <div class="section" id="dir-2-title">
+            <h1>Dir 2 Title</h1>
+            
+    <p>Lorem Ipsum Dolor.</p>
+
+    </div>
+                    <!-- content end -->
+                </div>
+            </div>
+        </div>
+    </div>
+</main>
+        
+<!-- Optional JavaScript; choose one of the two! -->
+
+<!-- Option 1: Bootstrap Bundle with Popper -->
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM" crossorigin="anonymous"></script>
+
+<!-- Option 2: Separate Popper and Bootstrap JS -->
+<!--
+<script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.9.2/dist/umd/popper.min.js" integrity="sha384-IQsoLXl5PILFhosVNubq5LC7Qb9DXgDA9i+tQ8Zj3iwWAwPtgFTxbJ8NT4GN1R8p" crossorigin="anonymous"></script>
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.min.js" integrity="sha384-cVKIPhGWiC2Al4u+LWgxfKTRIcfu0JTxR+EQDz/bgldoEyl4H0zUF0QKbrJ0EcQF" crossorigin="anonymous"></script>
+-->
+</body>
+</html>
\ No newline at end of file
diff --git a/tests/Integration/tests-full/markdown-full/nested-menu-md/expected/dir2/somePage.html b/tests/Integration/tests-full/markdown-full/nested-menu-md/expected/dir2/somePage.html
new file mode 100644
index 000000000..25b2abeda
--- /dev/null
+++ b/tests/Integration/tests-full/markdown-full/nested-menu-md/expected/dir2/somePage.html
@@ -0,0 +1,125 @@
+<!DOCTYPE html>
+<html class="no-js" lang="en">
+<head>
+    <title>Some Page in dir 2</title>
+    <!-- Required meta tags -->
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+        
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC" crossorigin="anonymous">
+</head>
+<body>
+<header class="">
+        
+<nav class="navbar navbar-expand-lg navbar-dark bg-primary">
+    <div class="container">
+
+        <a class="navbar-brand" href="#">Navbar</a>
+        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
+            <span class="navbar-toggler-icon"></span>
+        </button>
+        <div class="collapse navbar-collapse" id="navbarSupportedContent">
+                                
+<ul class="navbar-nav me-auto mb-2 mb-lg-0">
+    <li class="nav-item">
+            <a href="../anotherPage.html" class="nav-link">
+                Another Page
+            </a>
+        </li><li class="nav-item">
+            <a href="../dir1/index.html" class="nav-link">
+                Dir 1 Title
+            </a>
+        </li><li class="nav-item">
+            <a href="index.html" class="nav-link">
+                Dir 2 Title
+            </a>
+        </li><li class="nav-item">
+            <a href="#" class="nav-link current active" aria-current="page">
+                Some Page in dir 2
+            </a>
+        </li><li class="nav-item">
+            <a href="../somePage.html" class="nav-link">
+                Some Page
+            </a>
+        </li><li class="nav-item">
+            <a href="../yetAnotherPage.html" class="nav-link">
+                Yet Another Page
+            </a>
+        </li></ul>
+
+                    </div>
+    </div>
+</nav>
+</header>
+<main id="main-content">
+    <div class="container">
+        <div class="container">
+            <div class="row">
+                <div class="col-lg-3">
+                                <nav class="nav flex-column">
+        <ul class="menu-level-main">
+        <li>
+            <a href="../anotherPage.html"
+               class="nav-link">Another Page</a>
+        </li>
+        <li>
+            <a href="../dir1/index.html"
+               class="nav-link">Dir 1 Title</a>
+        </li>
+        <li>
+            <a href="index.html"
+               class="nav-link">Dir 2 Title</a>
+            <ul>
+                <li>
+                    <a href="#"
+                       class="nav-link current active" aria-current="page">Some Page in dir 2</a>
+                </li>
+            </ul>
+        </li>
+        <li>
+            <a href="../somePage.html"
+               class="nav-link">Some Page</a>
+        </li>
+        <li>
+            <a href="../yetAnotherPage.html"
+               class="nav-link">Yet Another Page</a>
+        </li>
+            </ul>
+</nav>
+
+                </div>
+                <div class="col-lg-9">
+                        
+<nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+        <li class="breadcrumb-item"><a href="../index.html">Document Title</a></li>
+        <li class="breadcrumb-item"><a href="index.html">Dir 2 Title</a></li>
+        <li class="breadcrumb-item"><a href="#">Some Page in dir 2</a></li>
+            </ol>
+</nav>
+                    <!-- content start -->
+                        <div class="section" id="some-page-in-dir-2">
+            <h1>Some Page in dir 2</h1>
+            
+    <p>Lorem Ipsum <code>Dolor</code>.</p>
+
+    </div>
+                    <!-- content end -->
+                </div>
+            </div>
+        </div>
+    </div>
+</main>
+        
+<!-- Optional JavaScript; choose one of the two! -->
+
+<!-- Option 1: Bootstrap Bundle with Popper -->
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM" crossorigin="anonymous"></script>
+
+<!-- Option 2: Separate Popper and Bootstrap JS -->
+<!--
+<script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.9.2/dist/umd/popper.min.js" integrity="sha384-IQsoLXl5PILFhosVNubq5LC7Qb9DXgDA9i+tQ8Zj3iwWAwPtgFTxbJ8NT4GN1R8p" crossorigin="anonymous"></script>
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.min.js" integrity="sha384-cVKIPhGWiC2Al4u+LWgxfKTRIcfu0JTxR+EQDz/bgldoEyl4H0zUF0QKbrJ0EcQF" crossorigin="anonymous"></script>
+-->
+</body>
+</html>
\ No newline at end of file
diff --git a/tests/Integration/tests-full/markdown-full/nested-menu-md/expected/index.html b/tests/Integration/tests-full/markdown-full/nested-menu-md/expected/index.html
new file mode 100644
index 000000000..69514672a
--- /dev/null
+++ b/tests/Integration/tests-full/markdown-full/nested-menu-md/expected/index.html
@@ -0,0 +1,124 @@
+<!DOCTYPE html>
+<html class="no-js" lang="en">
+<head>
+    <title>Document Title</title>
+    <!-- Required meta tags -->
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+        
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC" crossorigin="anonymous">
+</head>
+<body>
+<header class="">
+        
+<nav class="navbar navbar-expand-lg navbar-dark bg-primary">
+    <div class="container">
+
+        <a class="navbar-brand" href="#">Navbar</a>
+        <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
+            <span class="navbar-toggler-icon"></span>
+        </button>
+        <div class="collapse navbar-collapse" id="navbarSupportedContent">
+                                
+<ul class="navbar-nav me-auto mb-2 mb-lg-0">
+    <li class="nav-item">
+            <a href="anotherPage.html" class="nav-link">
+                Another Page
+            </a>
+        </li><li class="nav-item">
+            <a href="dir1/index.html" class="nav-link">
+                Dir 1 Title
+            </a>
+        </li><li class="nav-item">
+            <a href="dir2/index.html" class="nav-link">
+                Dir 2 Title
+            </a>
+            <ul>
+                <li class="nav-item">
+                    <a href="dir2/somePage.html" class="nav-link">
+                        Some Page in dir 2
+                    </a>
+                </li>
+            </ul>
+        </li><li class="nav-item">
+            <a href="somePage.html" class="nav-link">
+                Some Page
+            </a>
+        </li><li class="nav-item">
+            <a href="yetAnotherPage.html" class="nav-link">
+                Yet Another Page
+            </a>
+        </li></ul>
+
+                    </div>
+    </div>
+</nav>
+</header>
+<main id="main-content">
+    <div class="container">
+        <div class="container">
+            <div class="row">
+                <div class="col-lg-3">
+                                <nav class="nav flex-column">
+        <ul class="menu-level-main">
+        <li>
+            <a href="anotherPage.html"
+               class="nav-link">Another Page</a>
+        </li>
+        <li>
+            <a href="dir1/index.html"
+               class="nav-link">Dir 1 Title</a>
+        </li>
+        <li>
+            <a href="dir2/index.html"
+               class="nav-link">Dir 2 Title</a>
+        </li>
+        <li>
+            <a href="dir2/somePage.html"
+               class="nav-link">Some Page in dir 2</a>
+        </li>
+        <li>
+            <a href="somePage.html"
+               class="nav-link">Some Page</a>
+        </li>
+        <li>
+            <a href="yetAnotherPage.html"
+               class="nav-link">Yet Another Page</a>
+        </li>
+            </ul>
+</nav>
+
+                </div>
+                <div class="col-lg-9">
+                        
+<nav aria-label="breadcrumb">
+    <ol class="breadcrumb">
+        <li class="breadcrumb-item"><a href="#">Document Title</a></li>
+            </ol>
+</nav>
+                    <!-- content start -->
+                        <div class="section" id="document-title">
+            <h1>Document Title</h1>
+            
+    <p>Lorem Ipsum Dolor.</p>
+
+    </div>
+                    <!-- content end -->
+                </div>
+            </div>
+        </div>
+    </div>
+</main>
+        
+<!-- Optional JavaScript; choose one of the two! -->
+
+<!-- Option 1: Bootstrap Bundle with Popper -->
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-MrcW6ZMFYlzcLA8Nl+NtUVF0sA7MsXsP1UyJoMp4YLEuNSfAP+JcXn/tWtIaxVXM" crossorigin="anonymous"></script>
+
+<!-- Option 2: Separate Popper and Bootstrap JS -->
+<!--
+<script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.9.2/dist/umd/popper.min.js" integrity="sha384-IQsoLXl5PILFhosVNubq5LC7Qb9DXgDA9i+tQ8Zj3iwWAwPtgFTxbJ8NT4GN1R8p" crossorigin="anonymous"></script>
+<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/js/bootstrap.min.js" integrity="sha384-cVKIPhGWiC2Al4u+LWgxfKTRIcfu0JTxR+EQDz/bgldoEyl4H0zUF0QKbrJ0EcQF" crossorigin="anonymous"></script>
+-->
+</body>
+</html>
\ No newline at end of file
diff --git a/tests/Integration/tests-full/markdown-full/nested-menu-md/input/anotherPage.md b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/anotherPage.md
new file mode 100644
index 000000000..02e0321a5
--- /dev/null
+++ b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/anotherPage.md
@@ -0,0 +1,3 @@
+# Another Page
+
+Lorem Ipsum Dolor.
diff --git a/tests/Integration/tests-full/markdown-full/nested-menu-md/input/dir1/index.md b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/dir1/index.md
new file mode 100644
index 000000000..862aaea1a
--- /dev/null
+++ b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/dir1/index.md
@@ -0,0 +1,3 @@
+# Dir 1 Title
+
+Lorem Ipsum Dolor.
diff --git a/tests/Integration/tests-full/markdown-full/nested-menu-md/input/dir2/index.md b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/dir2/index.md
new file mode 100644
index 000000000..2f91b9fee
--- /dev/null
+++ b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/dir2/index.md
@@ -0,0 +1,3 @@
+# Dir 2 Title
+
+Lorem Ipsum Dolor.
diff --git a/tests/Integration/tests-full/markdown-full/nested-menu-md/input/dir2/somePage.md b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/dir2/somePage.md
new file mode 100644
index 000000000..082675e84
--- /dev/null
+++ b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/dir2/somePage.md
@@ -0,0 +1,4 @@
+
+# Some Page in dir 2
+
+Lorem Ipsum `Dolor`.
diff --git a/tests/Integration/tests-full/markdown-full/nested-menu-md/input/guides.xml b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/guides.xml
new file mode 100644
index 000000000..4759d605e
--- /dev/null
+++ b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/guides.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<guides xmlns="https://www.phpdoc.org/guides"
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:schemaLocation="https://www.phpdoc.org/guides packages/guides-cli/resources/schema/guides.xsd"
+        theme="bootstrap"
+        input-format="md"
+        links-are-relative="1"
+        automatic-menu="true"
+>
+    <extension class="phpDocumentor\Guides\Bootstrap"/>
+</guides>
diff --git a/tests/Integration/tests-full/markdown-full/nested-menu-md/input/index.md b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/index.md
new file mode 100644
index 000000000..9f6ae85ae
--- /dev/null
+++ b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/index.md
@@ -0,0 +1,3 @@
+# Document Title
+
+Lorem Ipsum Dolor.
diff --git a/tests/Integration/tests-full/markdown-full/nested-menu-md/input/skip b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/skip
new file mode 100644
index 000000000..95484cd4d
--- /dev/null
+++ b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/skip
@@ -0,0 +1 @@
+Nested autocreated menus are not yet supported
\ No newline at end of file
diff --git a/tests/Integration/tests-full/markdown-full/nested-menu-md/input/somePage.md b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/somePage.md
new file mode 100644
index 000000000..bc2473dd3
--- /dev/null
+++ b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/somePage.md
@@ -0,0 +1,4 @@
+
+# Some Page
+
+Lorem Ipsum `Dolor`.
diff --git a/tests/Integration/tests-full/markdown-full/nested-menu-md/input/yetAnotherPage.md b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/yetAnotherPage.md
new file mode 100644
index 000000000..fd7c625a3
--- /dev/null
+++ b/tests/Integration/tests-full/markdown-full/nested-menu-md/input/yetAnotherPage.md
@@ -0,0 +1,3 @@
+# Yet Another Page
+
+Lorem Ipsum Dolor.