Introduction

Frequently Asked Questions

Common questions about Mark It Down.

FAQ

💾 Data & Storage
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
📝 Notes Management
How do I delete notes?

Deletion is a 2-step process for safety.

  1. Step 1: Move to Trash — Delete button moves notes to Trash (can be restored)
  2. 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 # Heading or ## Heading becomes 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%+)
🖼️ Images & Media
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 ![](https://...)
  • 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.

📦 Archive & Large Files
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.

⚙️ Git & Tools
How do I set up Git sync?

Connect to GitHub or GitLab in a few steps.

  1. Open Git Settings (Command Palette → "Git Settings")
  2. Select provider (GitHub or GitLab)
  3. Enter your token, repository URL, and branch
  4. 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.