Core Concepts

Overview

AutoMD is built on a simple idea: your project management data is just markdown files. There’s no database, no proprietary format — just .md files that you can read, edit, and version-control with git.

Boards

A board is a single markdown file. Each # Heading becomes a column in kanban view.

Tasks

Tasks are markdown checkboxes (- [ ] or - [x]). Each task can have metadata tags inline.

Metadata

Tags like @assignee, #label, priority:high, due:friday, and est:4h are parsed from the task text and displayed as structured data in the UI.

Views

Every board has three views of the same file:

  • Editor — raw markdown with syntax highlighting
  • Checklist — filterable, sortable task list
  • Kanban — drag-and-drop columns and cards

Info

Detailed documentation for each concept coming soon.