markmap-anywidget 0.1.4

anywidget to make interactive mindmaps from markdown using markmap in interactive computing environments

markmap-anywidget

A simple anywidget implementation of markmap for Jupyter and marimo notebooks.

Installation

# Using pip
pip install markmap-anywidget

# Using uv
uv add markmap-anywidget

Usage with marimo

See the marimo documentation for more information on using anywidget.

import marimo as mo
from markmap_anywidget import MarkmapWidget

widget = mo.ui.anywidget(
    MarkmapWidget(
        markdown_content="""---
markmap:
  colorFreezeLevel: 2
  maxWidth: 300
---

# markmap

## Links
- [Website](https://markmap.js.org/)
- [GitHub](https://github.com/gera2ld/markmap)

## Features
- `inline code`
- **strong** and *italic*
- Katex: $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$
"""
    )
)

# In a marimo cell, displaying the widget is enough
widget

Development

This project uses Nix with nix-direnv for a reproducible development environment.

# Clone the repository
git clone [e-mail]:daniel-fahey/markmap-anywidget.git
cd markmap-anywidget

# Enter Nix development environment
direnv allow

# Install dependencies
uv sync

Building

Complete build (recommended):

# Using make (includes clean, build, and quality checks)
make all

Build only (faster for development):

# Using make
make build
# or:
cd js && pnpm install && pnpm build
cd .. && uv build

Development mode (watch for changes):

# Using make
make dev

# Manual equivalent
cd js && pnpm dev

Quality Checks

Run all quality checks:

# Using make (includes lint, type-check, and test)
make check

Individual checks:

# Linting
make lint
# or:
uv run ruff check src/ examples/ tests/

# Type checking
make type-check
# or:
uv run mypy src/

# Testing
make test
# or:
uv run pytest

Available Commands

Show all available Makefile targets:

make
# or:
make help

Examples

Run the marimo example:

uv run python -m marimo edit --watch examples/marimo.py