Markdown Format

File structure

AutoMD reads standard markdown files. The structure is simple:

  • # Headings become kanban columns
  • - [ ] checkboxes become task cards
  • Everything else (paragraphs, code blocks, etc.) is preserved as-is

Example

# Backlog

- [ ] Design the landing page @alice #design priority:high
- [ ] Write API documentation @bob #docs

# In Progress

- [ ] Implement auth flow @charlie #backend due:friday

# Done

- [x] Set up project repository @alice

Heading levels

Only # H1 headings are used as kanban columns. You can use ## H2 and below within a section for notes or sub-organization — they won’t create new columns.

Info

Full specification and edge cases coming soon.