Introduction
Frequently Asked Questions
Common questions about Mark It Down.
FAQ
Will my data be deleted if I clear Chrome's cache?
No. Notes are stored in a dedicated extension storage area, separate from browser cache.
- Browser cache cleared → Data is preserved ✓
- Extension uninstalled → Data is deleted ⚠️
Tip: Use Git sync for external backup before uninstalling.
Can I use Mark It Down offline?
Yes — everyday writing is fully offline.
Works offline:
- Editing, saving, and note management (chrome.storage.local)
- Mermaid diagrams, KaTeX math, and syntax highlighting (all bundled)
- Export: PDF, PNG, DOCX, .md — all processed locally
- Themes, Find & Replace, TOC, Command Palette
- Cross-Instance Compare & Edit
Requires internet:
- Web Clipper (needs a live page to clip)
- AI Chat Extraction (Claude, ChatGPT, Grok, Gemini)
- Git sync (Push, Pull, Fetch)
- HTML export (non-self-contained) and math zoom — CDN for KaTeX CSS
How do I delete notes?
Deletion is a 2-step process for safety.
- Step 1: Move to Trash — Delete button moves notes to Trash (can be restored)
- Step 2: Permanent delete — Delete from Trash to remove permanently
With Git sync: Synced notes require a Sync after moving to Trash to delete from remote. The Trash badge (Synced/Pending/Local) shows the sync status.
Note: System notes (guides in the System folder) are protected and cannot be deleted or edited.
How do I rename a note?
The title is automatically extracted from your note content.
- First
# Headingor## Headingbecomes the title - If no heading, the first line is used (max 50 characters)
With Git sync: Filenames on remote may differ from titles. Special characters like : or / are converted to _ for safe file paths.
Simply edit the first heading to rename your note.
Will the app slow down if I have too many notes?
Mark It Down is designed as a workspace, not a storage system.
Recommended usage:
- Keep around 20 active notes
- Export completed notes: Archive → Export → Delete
- Check storage usage in the sidebar (warning at 80%+)
Can I paste images into notes?
Image files cannot be saved as attachments. Mark It Down is a text-based Markdown editor.
- Image URLs: You can include image links like
 - Pasting from web: May insert the image URL as a Markdown link
- Screenshot paste: Some apps include image data as
data:image/...which appears in your note as text
If an image "worked": Check your note source — it's either an external URL or a base64 data URL embedded as text. Data URLs work offline but make notes very large.
For images, use external hosting and link to them in your notes.
What is Archive and how does it work?
Archive is a read-only folder for completed or reference notes.
- Notes in Archive open in a lightweight viewer (faster loading)
- To edit an archived note, click Unlock to move it back to Inbox
- Great for storing completed notes you want to reference but not accidentally edit
- Bulk export: Pin (★) notes in Archive, then use Export → "Pinned as ZIP" to download them together
What happens with large files (100KB+)?
Large files are handled with optimized settings.
- 100KB+: Some features (syntax highlighting, LaTeX) are disabled for faster loading
- 300KB+: A dialog appears with options to open as read-only in Archive
Mark It Down is designed for editing, not storing large raw files. Consider exporting very large files.
How do I set up Git sync?
Connect to GitHub or GitLab in a few steps.
- Open Git Settings (Command Palette → "Git Settings")
- Select provider (GitHub or GitLab)
- Enter your token, repository URL, and branch
- Click Test Connection, then Save
Your token is encrypted and stored securely.
What can I do with the Command Palette?
Quick access to most features via Cmd/Ctrl + Shift + P.
- Notes: New note, search, import
- Edit: Undo/Redo, Find & Replace, format tables
- Move: Pin, move to Archive/Template/Trash
- Git: Sync, Pull, Push, settings
- View: Toggle sidebar, TOC, focus mode, themes
- Insert: Mermaid diagrams, code blocks, math equations
Still have questions?
Check out Troubleshooting or send us feedback.