Logbook
The logbook (bitácora) is a collaborative markdown editor for an investigation’s notes and findings. It works Overleaf-style: you write markdown source on one side and see the rendered preview on the other.
Use the logbook to narrate your research as it happens — record what you tried, link to the exact experiments and trials behind a claim, and publish immutable snapshots you can cite later.
Source, preview & split view
Section titled “Source, preview & split view”The editor offers three modes:
| Mode | Component | What you see |
|---|---|---|
| Source | LogbookSource | Raw markdown only |
| Preview | LogbookPreview | Rendered output only |
| Split | LogbookEditor | Source and live preview side by side |
Split view keeps the rendered result in sync as you type, so you can write and read at once.
References & @mentions
Section titled “References & @mentions”The logbook supports references to other research objects via auto-complete @mentions:
- Experiments — link to an experiment by name.
- Trials — point at a specific trial behind a result.
- Team members — mention a collaborator.
-
Type
@where you want a reference. -
Pick the experiment, trial, or member from the auto-complete list.
-
The reference is inserted inline and renders as a link in the preview, so claims stay traceable to the runs that produced them.
Published snapshots
Section titled “Published snapshots”When you want a stable, citable version, publish a snapshot. Published snapshots are immutable versions — a frozen record of the logbook at that point. Continue editing the live document afterward; earlier snapshots remain unchanged for reference and reproducibility.