Performance on Large Documents

Symptom

Very large documents (1MB+) may take a moment to open or feel sluggish when scrolling.

How Markant handles large files

Markant uses progressive rendering: the first 30 blocks are rendered synchronously (so you see content immediately), then the rest renders asynchronously in the background. For most documents, this means:

• < 100KB — opens in under 100ms
• 100KB–1MB — first screen in under 300ms
• 1MB+ — first screen quickly, full document within a few seconds

Tips for large documents

• Theme switching rebuilds all text attachments (code blocks, tables, math). On large documents with many of these, you may notice a brief delay.
• MarkBooks with many chapters perform well because only the current chapter is rendered at full fidelity.
• Documents with many images — Markant loads images lazily, but having 50+ large images in a single page will use more memory.

Memory usage

Markant targets under 50MB for typical documents. Very large documents with many embedded code blocks and math equations may use more.