Skip to content
Handbook
EN DE
Open markbird

← Handbook

FAQ & troubleshooting

Is it free?

Yes, today. Optional cross-device sync and collaboration may become a paid plan later. Local writing is the part we intend to keep free.

Do I need an account?

No. See Account & sync.

Where are my documents?

In your browser, unless you signed in or shared. See Privacy & data.

Will I lose my work if I clear my browser data?

Yes — local documents live in browser storage. Use scheduled local backups, export the library as a .zip, or sign in for sync.

Can I keep my notes in a Git repository?

Yes. Use Open file from disk… and Save to file to edit real files in place, or point scheduled backups at a folder in your repository.

My documents are not syncing

Check the sync indicator. Offline — changes queued means it is waiting for a connection. Sync error usually means signing out and back in will help. Sync is last-write-wins; an overwritten version is recoverable from version history.

Search finds nothing right after I open the app

The index builds in the background so start-up stays fast. The first search may wait a moment.

Maths or a diagram is not rendering

Check the fence language is mermaid, and that maths uses $…$ or $$…$$. Both load on demand, so a slow first render on a large document is expected.

The Word export lost my maths or diagram

Maths: you most likely exported while offline. The on-device converter degrades maths to its TeX source; export again with a connection and it becomes native Word equations.

Diagrams: Mermaid diagrams never become pictures in Word, online or not. Use PDF or HTML for those. See Export & import.

Sending from Claude does not work

See the troubleshooting section of the Claude integration page.

It expired or was revoked. Check Manage shared links….

Still stuck?

Email hi@markbird.md, or see Support.