Drupal is a registered trademark of Dries Buytaert
drupal 10.6.12 — Update released for Drupal core (10.6.12)! drupal 11.3.13 — Update released for Drupal core (11.3.13)! drupal 10.6.11 — Update released for Drupal core (10.6.11)! drupal 11.3.12 — Update released for Drupal core (11.3.12)! drupal 11.2.14 — Update released for Drupal core (11.2.14)! drupal 10.5.12 — Update released for Drupal core (10.5.12)! cms 2.1.3 — Update released for Drupal core (2.1.3)! drupal 10.5.11 — Update released for Drupal core (10.5.11)! drupal 11.3.11 — Update released for Drupal core (11.3.11)! drupal 11.2.13 — Update released for Drupal core (11.2.13)! drupal 10.6.10 — Update released for Drupal core (10.6.10)! cms 2.1.2 — Update released for Drupal core (2.1.2)! drupal 11.1.10 — Update released for Drupal core (11.1.10)! drupal 10.5.10 — Update released for Drupal core (10.5.10)! drupal 10.4.10 — Update released for Drupal core (10.4.10)! drupal 11.2.12 — Update released for Drupal core (11.2.12)! drupal 11.3.10 — Update released for Drupal core (11.3.10)! drupal 10.6.9 — Update released for Drupal core (10.6.9)! drupal 10.6.8 — Update released for Drupal core (10.6.8)! drupal 11.3.9 — Update released for Drupal core (11.3.9)!
← All modules

md_navigator

No security coverage
View on drupal.org

MD Navigator

MD Navigator adds a two-panel file browser to the Drupal admin interface that lets you navigate and read `.md` files stored anywhere in your Drupal filesystem — without leaving the browser.

Browse your custom module and theme documentation, Drupal core READMEs, or any tree of Markdown files you configure. Click a directory to drill in, click a file to read it rendered as clean HTML on the right.

Use cases

  • **Developers** — read module README files, CHANGELOG entries, and inline documentation while working inside Drupal without switching to a terminal or text editor
  • **Technical teams** — keep a `docs/` folder of project notes, decisions, and runbooks browsable from the Drupal admin
  • **Site builders** — browse the README files of installed modules and themes to quickly look up configuration options and hooks
  • **Drupal agencies** — maintain client-facing handoff documentation as `.md` files in a custom module, browsable by anyone with the right role

Features

  • Hierarchical sidebar showing only directories and files that contain `.md` content — no noise from other file types
  • Drill into subdirectories and navigate back with the Up button
  • Full Markdown rendering: headings, bold, italic, tables, code blocks, blockquotes
  • **Search** — type a term to search across all configured directories simultaneously; results are split into filename matches and content matches with highlighted excerpts
  • Configurable starting directories — point the browser at `modules/custom`, `themes/custom`, `core/modules`, or any path relative to the Drupal root
  • Role-based access via standard Drupal permissions

Optional editing (md_navigator_editor submodule)

The included `md_navigator_editor` submodule adds create and edit capability powered by the [MDX Editor](https://www.drupal.org/project/mdxeditor) module. Enable it when you need to:

  • Create new `.md` files directly from the browser
  • Edit existing files with a rich Markdown toolbar (bold, italic, headings, lists, code blocks, tables, source view)
  • Save changes back to the filesystem

`md_navigator` (browse and read) has no dependency on MDX Editor and works on any Drupal 11+ site. `md_navigator_editor` requires MDX Editor and is kept separate so sites that only need reading are not affected by that dependency.

Requirements

Related modules

Activity

Total releases
2
First release
Jun 2026
Latest release
2 hours ago
Release cadence
1 day
Stability
100% stable

Releases

Version Type Release date
1.0.1 Stable Jun 28, 2026
1.0.0 Stable Jun 27, 2026