✍️ Writing
MkDocs Material Nav Map from mkdocs.yml Inventory (No Invented Page Paths)
Turn an mkdocs.yml inventory into a Material nav map only. No invented page paths, nav titles, or plugin keys beyond the inventory.
0Reviews
Prompt
Act as a MkDocs Material documentation architect who only uses a pasted mkdocs.yml inventory. You write a nav map the inventory already supports. You do not invent page paths, nav titles, plugin keys, or theme palette values. This is not a live mkdocs build and not a migration quote. You work only from Inputs. Do not invent stats, citations, quotes, URLs, names, IDs, or records that are not in Inputs. Inputs: - mkdocs.yml inventory I lock (nav stubs, page cues, section notes): [Inventory] - MkDocs / Material version notes I lock: [Version] - Product or workspace label I may quote (or UNKNOWN): [Workspace] - Required nav or page names I may quote (or UNKNOWN): [SpecNames] - Nav section titles already present (or UNKNOWN): [NavSections] - Page path strings already present (or UNKNOWN): [PagePaths] - Plugin keys already present (or UNKNOWN): [PluginKeys] - Words I must not use: [Banned] - What I must never invent (page paths, nav titles, plugin keys, theme palette values): [Never] - Output format: [Format] - Language: [Lang] Generate: 1. Honesty ledger: Inventory nouns, Version, Workspace, SpecNames, NavSections, PagePaths, PluginKeys, Lang. Forbidden: invented page paths, nav titles, plugin keys, theme palette values. Banner: not a live mkdocs build; not a migration quote. 2. Nav map table: one row per Inventory nav stub or page cue. Missing section notes write NOT IN INPUTS. Use MkDocs Material nav, pages, plugins, and theme language when Inventory supports it. Quote NavSections and PagePaths only when present. 3. Spec name set: only names in SpecNames. Unnamed pages stay NOT IN INPUTS. Never print page-path or nav-title VALUES not in Inventory. 4. Version lock: print Version. Refuse Material features newer than Version if Version is named. 5. Refuse list: inventing page paths, inventing nav titles, inventing plugin keys, inventing theme palette values. 6. Compliance pass: quote Banned and Never hits. Cut them. Format as Format. Constraints: - Map from Inventory only. No invented page-path VALUES. Teach MkDocs Material nav mapping, not a generic Sphinx swap. - Honor Version. No emojis.
Instructions
Replace every [bracket] with your details before running. Works on ChatGPT, Claude, and Gemini.
Generated Output
This image was generated using the prompt above.

Examples
Example Input
Inventory: nav Harbor Quay Install Section as pasted page cue docs/install/cleat.md as pasted section note Primary as pasted; nav River Ops API Section as pasted page cue docs/api/gate.md as pasted. Page path invent NONE. Plugin key NOT IN INPUTS. Version: MkDocs 1.6 Material 9.5 as pasted (do not invent unreleased AI search APIs) Workspace: Harbor Quay Docs MkDocs as pasted SpecNames: Install Section as pasted; API Section as pasted. Changelog UNKNOWN. NavSections: Harbor Quay Install Section as pasted; River Ops API Section as pasted. Glossary UNKNOWN. PagePaths: docs/install/cleat.md as pasted; docs/api/gate.md as pasted. docs/faq.md UNKNOWN. PluginKeys: search as pasted; tags as pasted. social UNKNOWN. Banned: guaranteed path, nav invent, plugin invent, palette invent Never: invent page paths, invent nav titles, invent plugin keys, invent theme palette values Format: ledger + table + specs + version + refuse + compliance Lang: English
Example Output
1. Ledger. Inventory: nav Harbor Quay Install Section page cue docs/install/cleat.md section note Primary; nav River Ops API Section page cue docs/api/gate.md. Page path invent NONE. Plugin key NOT IN INPUTS. Version MkDocs 1.6 Material 9.5. Workspace Harbor Quay Docs MkDocs. SpecNames Install Section; API Section; Changelog UNKNOWN. NavSections Harbor Quay Install Section; River Ops API Section; Glossary UNKNOWN. PagePaths docs/install/cleat.md; docs/api/gate.md; docs/faq.md UNKNOWN. PluginKeys search; tags; social UNKNOWN. Lang English. Banner: not a live mkdocs build; not a migration quote. Forbidden: invented page paths, nav titles, plugin keys, theme palette values, guaranteed path, nav invent, plugin invent, palette invent. 2. Nav map. 1. Harbor Quay Install Section | nav Harbor Quay Install Section as pasted (NavSections) | page docs/install/cleat.md as pasted (PagePaths) | section note Primary as pasted | plugins search/tags as pasted (PluginKeys) | path invent NONE | MkDocs Material nav map only. 2. River Ops API Section | nav River Ops API Section as pasted (NavSections) | page docs/api/gate.md as pasted (PagePaths) | section note NOT IN INPUTS | plugins NOT IN INPUTS | path invent NONE. Theme palette values not invented. Social plugin not printed beyond PluginKeys. 3. Spec name set. Install Section; API Section as SpecNames. Changelog UNKNOWN so write Changelog NOT IN INPUTS. No page-path VALUES beyond PagePaths. No third nav invented. 4. Version lock. MkDocs 1.6 Material 9.5 as pasted. Unreleased AI search APIs not used. Instant navigation NOT IN INPUTS. 5. Refuse. Path invent: refused. Nav invent: refused. Plugin invent: refused. Palette invent: refused. Guaranteed path: refused. 6. Compliance. Banned hits none. Format ledger+table+specs+version+refuse+compliance. Gaps: section note for River Ops API Section, Changelog decision, docs/faq.md PagePaths, social PluginKeys, Glossary NavSections if any. Missing-data policy: if a field was blank, write NOT IN INPUTS rather than guessing. Lock any tool version named in Inputs; if unnamed, write unknown. No invented testimonials, star ratings, or press logos. If legal, clinical, insurance, HR, education-plan, or veterinary content appears, add a one-line not-advice and de-identify banner. Quote banned-word hits and cut them. End with a gaps list of five bullets the user still owes you. Character and byte caps in the job are hard; print counts when relevant. Refuse to backfill DOIs, exam dumps, PHI, PII, or compensation promises not in Inputs.