Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Unreleased
Changed
- BREAKING:
show_tagsnow displays tags as separate nodes in the graph view instead of appending them to page titles - Tags appear as distinct hollow/outlined nodes with accent color
- Tag labels include hashtag (#) prefix
- Pages are connected to their tag nodes via edges
- Tag nodes are clickable if a tags index exists (navigates to tag section)
- Inspired by Quartz's graph view
0.1.0 - 2025-11-29
- Initial release of MkDocs Graph Plugin
Added
- Mini graph view in sidebar showing connected pages
- Full graph overlay with all documentation pages
- Configurable graph depth using BFS algorithm
- D3.js force-directed layout visualization
- Responsive design (mobile and desktop)
- Material theme integration
- Dark mode support
- Configurable physics simulation (repel force, center force, link distance)
- Visual customization options (scale, font size, tag display)
- Interaction controls (drag, zoom, hover effects)
- Tag support integration
- Touch device support
- Automatic resize handling
- Link deduplication and weighting
- Performance optimizations for large documentation sites
Configuration Options
enabled- Enable/disable pluginlocal_graph_depth- Graph depth for mini viewglobal_graph- Enable full graph overlayrepel_force- Node repulsion strengthcenter_force- Centering force strengthlink_distance- Distance between connected nodesscale- Overall graph scalefont_size- Label font sizeshow_tags- Display page tagsenable_drag- Allow node draggingenable_zoom- Allow zoom and panfocus_on_hover- Highlight on hover