MD_Manager

MD_Manager is an interactive, fully local Markdown project workspace for Git, automation, and AI agents.
Plan visually while keeping your project data open, portable, and human-readable.

Key features

• Visual planning in a focused workspace. Optimized for both landscape and portrait monitors.
• Releases, tasks, todos, backlog, metadata, and progress tracking.
• Drag and drop, copy and paste, and keyboard controls.
• Undo and redo with view-state restoration.
• Project-wide fuzzy search with keyboard navigation to matching content.
• External-change detection, reload or overwrite resolution, and retryable saves.
• Markdown editing with tags, templates, and inline formatting.
• Archive timeline ordered by date or version, including ranges and paused periods.
• Fully local and offline, with no cloud services, installation, build step, or web server.

Editing dialog	Archive timeline

Themes: Gruvbox Light / Dark.

Quick Start

Launching

The application consists of plain HTML, CSS, and JavaScript. It has no build step, package-manager runtime, web server, framework, or CDN dependency.

Just open MD_Manager.html in a Chromium-based browser with support for the File System Access API.

Markdown Example

An example is stored locally in data/parsing/Layout.md which also serves as the golden file for parsing.

Data

• Markdown is the canonical project format.
• Parsing creates plain JavaScript state.
• Serialization writes state changes back to the open file.
• File handles for the five most recently opened projects are stored in IndexedDB.
  • Project content remains in its Markdown file.

The document base structure is:

# Project
└── ## Feature
    └── ### Task
        ├── #### Grouping
        └── - [ ] Todo

Supported tags:

• #Version and #Date define release metadata.
• #Info and #Warn add contextual notes to features and tasks.
• #Ignore preserves the following feature or task in Markdown while hiding it from the application.
• #Archive start the archive section. Only finished features can be archived.
• #Backlog starts the backlog section. Only tasks can be put in the backlog.
• #Pin marks a single feature for fast navigation and highlighting.

Supported formatting:

• **bold**, *italic*, ~strikethrough~, and `inline code`.
• Links, paragraphs, and nested unordered lists.

Technical implementation

MD_Manager uses a layered architecture built around Markdown as the data source. Pure domain operations manage state transitions independently of the DOM, the I/O layer handles parsing and local file access, and the UI layer renders state and delegates persistent changes back to the domain. app.js connects these layers and coordinates the application lifecycle, keeping business rules, persistence, and presentation independently testable.

Localized state changes use targeted DOM updates where possible. Repeated layout work is coalesced through animation frames, stable measurements are cached with explicit invalidation, and observers are limited to active interaction lifecycles.

Project structure

MD_Manager/
├── .codex/                  # Project-local Codex skills
├── .github/                 # Verification and release workflows
├── data/
│   ├── parsing/             # Canonical Markdown parsing fixture
│   └── templates/           # Bundled feature and task templates
├── docs/                    # Project roadmap and active work specification
├── domain/                  # Pure business rules and state transitions
├── io/                      # Markdown and local file access
├── res/
│   ├── fonts/               # Local interface fonts
│   ├── icons/               # Deterministic UI symbols
│   ├── logo/                # Application logo assets
│   └── screenshots/         # Automated captures and composites
├── tests/
│   ├── e2e/                 # Playwright interaction and layout tests
│   └── unit/                # DOM-independent Node.js tests
├── tools/                   # Architecture and statistics checks
├── types/                   # Global JSDoc type declarations
├── ui/                      # Rendering, layout, and interactions
├── vendor/                  # Local libraries and licenses
├── app.js                   # Application wiring and lifecycle
├── MD_Manager.html          # Entry point
└── styles.css               # Styles and theme tokens

Testing and verification

Node.js and npm are required only for development checks:

npm ci
npm run verify

The verification pipeline runs strict TypeScript checking for JavaScript with JSDoc, ESLint with zero warnings, the harness doctor, architecture-boundary checks, unit tests, and Playwright tests in Chromium.

CI executes the complete pipeline on Windows, Linux, and macOS.

Releases

Release	Date	Lines of code			Tests	Main features
		HTML	CSS	JS
v0.8.0	15.08.2026	600	557	5,332	234	Timeline improvements, workspace search
v0.7.1	12.08.2026	557	474	4,322	166	Feature pinning, archive timeline
v0.6.0	07.08.2026	538	385	3,351	107	UI polish, README, release workflow
v0.5.0	03.08.2026	512	376	3,321	96	Cross-platform improvements
v0.4.0	03.08.2026	279	392	3,255	90	New undo/redo system and file conflicts
v0.3.0	30.07.2026	271	373	2,763	76	Markdown features + editing
v0.2.0	29.07.2026	181	316	2,169	64	Notification system and copy/paste
v0.1.0	27.07.2026	166	270	1,566	50	Application foundation

Vendor

All production dependencies and fonts are stored locally.

Component	Version	Functionality	License
SortableJS	1.15.7	Drag and drop	MIT
Inter	4.1	Interface typography	SIL OFL 1.1
JetBrains Mono	2.304	Monospace font	SIL OFL 1.1

Thanks to all the creators and contributors of these projects!

License

MD_Manager is licensed under the MIT License.