> ## Documentation Index
> Fetch the complete documentation index at: https://harisfazillah.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Reference: mkdocs_hooks.py

> Custom MkDocs page compilation hook for relative Markdown URL rewriting. Deep State of Mind framework. Deep State of Mind framework.

Custom MkDocs page compilation hook for relative Markdown URL rewriting.

## Description

The `mkdocs_hooks.py` script intercepts static pages during compilation. It strips unnecessary `docs/` prefixes and normalises repository-root relative paths (`../../` to `../`), ensuring links work seamlessly on both GitHub.com and built HTML servers.

## Script path

`tools/mkdocs_hooks.py`

## CLI integration

Automated by the static site compiler. Registered inside `mkdocs.yml`:

```yaml theme={null}
hooks:
  - tools/mkdocs_hooks.py

```

## Functions

### `on_page_markdown(markdown, page, config, files)`

Interceptors registered by the MkDocs lifecycle.

* **Arguments:** `markdown` content (string), `page` metadata, `config` context, `files` collection.
* **Returns:** Modified Markdown string with rewritten relative URLs.

## Rewriting rules

* **External links:** Keeps `http://`, `https://`, `mailto:`, `ftp:`, and `#` anchor links unchanged.
* **`docs/` prefix:** Strips `docs/` from relative paths (e.g. `docs/governance/PROTOCOL.md` becomes `governance/PROTOCOL.md`).
* **`../../` prefix:** Normalises double-parent directories (e.g. `../../AGENTS.md` becomes `../AGENTS.md`).

***

*Deep State of Mind (DSOM) For My AI Protocol | Harisfazillah Jamel (LinuxMalaysia) | 2026-08-14*
*Standard: UK English | DBP-standard Bahasa Melayu Malaysia (Piawai) | GNU General Public License v3.0*


## Related topics

- [Reference Material Index](/reference/index.md)
- [Reference: generate_sitemaps.py](/reference/generate_sitemaps.md)
- [Automation & Script Audit Ledger](/governance/automation-audit-list.md)
- [🎓 DSOM Team Masterclass: Project Creation, GitOps & Multi-Agent Collaboration](/tutorials/team-dsom-masterclass.md)
- [DSOM - Deep State of Mind: AI Governance Framework](/index.md)