Skip to content

Documentation / MeatPad / FAQ

MeatPad FAQ

Answers about saving, boards, project editing, automation, privacy and backups. Browse by topic or search every answer.

MeatPad 0.31.4 · Released 13 October 2026 · Reviewed 20 October 2026

Browse questions by topic

FAQ topics
TopicQuestions coveredGuide
Getting startedWhich version does this manual cover?
Should I start a note or open a project?
Read guide: Getting started
Notes and foldersDo I need to save my notes?
How do I recover a deleted note?
Why is my note missing from search?
Why does clicking a link edit the text?
Read guide: Notes and folders
Boards, columns and cardsWhat is the difference between archive and delete?
What happens to cards when I delete a column?
Does Combine Columns merge the underlying boards?
Can I format card text as Markdown?
How do I label cards or set a deadline?
Does attaching a file move the original?
Can I turn a multiline card into separate cards?
Read guide: Boards, columns and cards
Projects and filesHow can I replace text in just one folder?
Why does project search show no matches?
How do I jump to a file without expanding the tree?
Read guide: Projects and files
Editing and MarkdownCan I edit several occurrences together?
Can I save a note as PDF?
How do I show completion without a language server?
Read guide: Editing and Markdown
Language serversDo language servers install automatically?
Which languages have server detection?
Read guide: Language servers
Terminal and GitDoes hiding the terminal clear its output?
Why did a Git menu item execute immediately?
Read guide: Terminal and Git
Snippets, commands and macrosWhy can I not edit a built-in snippet?
Are imported commands safe to run?
Can a macro automate the entire Mac?
What happens if I run a selection command with nothing selected?
Read guide: Snippets, commands and macros
Settings referenceWhy is a theme locked?
Where did a file-tree menu action go?
How do I use MeatPad without a Dock icon?
Read guide: Settings reference
Data, privacy and backupWhere are my notes and boards stored?
Does Export All Data include project folders?
Does MeatPad sync my library to a cloud account?
Does local storage mean no network activity?
Can I undo Delete All Data?
Read guide: Data, privacy and backup
Keyboard shortcutsWhy does a keyboard shortcut do nothing?Read guide: Keyboard shortcuts

Getting started

Which version does this manual cover?

MeatPad 0.31.4, released 13 October 2026. Check About MeatPad for your installed version. Download requirements are shown on the product page.

Follow the guide · Link to this answer

Should I start a note or open a project?

Choose New Note for the managed notebook library. Choose Open… for a folder of files you want to edit on disk. Notes autosave; project files use Save.

Follow the guide · Link to this answer

Notes and folders

Do I need to save my notes?

Notes autosave after a short pause and flush when closing the editor or leaving the app. Project file tabs use ⌘S. A literally empty note without attachments is discarded when closed.

Follow the guide · Link to this answer

How do I recover a deleted note?

Open Trash in All Notes, select it and choose Restore. If you permanently deleted it, restore a backup; the library Trash cannot restore purged notes.

Follow the guide · Link to this answer

Why is my note missing from search?

Check the active folder, clear the search and inspect Trash. Use the library search for notes and Find in Project for files. These are different stores.

Follow the guide · Link to this answer

Boards, columns and cards

What is the difference between archive and delete?

Archive hides a card from the normal board; Show Archived Cards reveals it and Unarchive Card returns it. Delete Card moves it to Board Trash, which has separate Restore and permanent-delete actions.

Follow the guide · Link to this answer

What happens to cards when I delete a column?

Live cards move to the first remaining column. The deleted column is recoverable in Board Trash, and restoring it moves its cards back. Permanently deleting the column trash entry does not delete those live cards.

Follow the guide · Link to this answer

Does Combine Columns merge the underlying boards?

No. It groups selected columns in the All Boards view. Clear removes that view grouping. Cards retain their originating boards.

Follow the guide · Link to this answer

Can I format card text as Markdown?

Enable Format card text as Markdown in General settings. Cards can display bold, italic and links while keeping their source text.

Follow the guide · Link to this answer

How do I label cards or set a deadline?

Use the card label menu to toggle labels or create a New Label…. The due-date menu offers Today, Tomorrow, Next Week and Custom…. Remove Due Date clears it.

Follow the guide · Link to this answer

Does attaching a file move the original?

An attachment is imported as a managed copy. Keep the original until you have checked the import. Include the managed attachment folders in your backup.

Follow the guide · Link to this answer

Can I turn a multiline card into separate cards?

Open Split into Cards and choose Split into Titles, Split into Notes or Split into Notes with Titles. The new cards stay in the same column and inherit labels/color. The original keeps attachments, deadline and note link. Undo reverses the split in one step.

Follow the guide · Link to this answer

Projects and files

How can I replace text in just one folder?

Right-click the folder and choose Find in Folder…. Review matches and options, enter Replace with and choose Replace All. Clear folder scope returns to project-wide search.

Follow the guide · Link to this answer

Why does project search show no matches?

Type at least two characters. Check the folder scope and Match Case, Regex and Whole Word switches. Whole Word is disabled with Regex; an invalid expression shows an error.

Follow the guide · Link to this answer

How do I jump to a file without expanding the tree?

Press ⌘T in a project window for Quick Open…, type part of its name/path and choose a result.

Follow the guide · Link to this answer

Editing and Markdown

Can I edit several occurrences together?

Use ⌘D to select a word and repeat to add its next occurrences, or Option-click for additional carets. Type once across the active selections; Escape returns to one.

Follow the guide · Link to this answer

How do I show completion without a language server?

Press Control-Space in a single-caret editor. Local words, project identifiers, keywords and snippet triggers are available alongside optional server results. Use arrows to choose, Tab/Return or click to accept, and Escape to cancel.

Follow the guide · Link to this answer

Language servers

Do language servers install automatically?

No. MeatPad detects installed programs. Install the appropriate server yourself, ensure it can be found by the login shell, then reopen the project. Highlighting and editing still work without it.

Follow the guide · Link to this answer

Which languages have server detection?

The released detector covers Swift (SourceKit-LSP), Rust (rust-analyzer), JavaScript/TypeScript/TSX (typescript-language-server) and Python (pyright-langserver). Each server supplies its own supported capabilities.

Follow the guide · Link to this answer

Terminal and Git

Does hiding the terminal clear its output?

Hiding and showing the panel returns to its existing session. Use View → Terminal (Control-`) inside a project window. A new or closed project window has its own lifecycle.

Follow the guide · Link to this answer

Why did a Git menu item execute immediately?

Run items send Return; Type items only prepare the prompt. Edit each row’s mode in Terminal settings. Review modes before choosing commands that modify a repository or contact a remote.

Follow the guide · Link to this answer

Snippets, commands and macros

Why can I not edit a built-in snippet?

Built-ins are read-only. Select Duplicate as editable copy, edit the new user snippet and Save. A matching user trigger/scope can shadow its built-in counterpart.

Follow the guide · Link to this answer

Are imported commands safe to run?

They are real shell scripts and start untrusted. Review the script, input/output, timeout and environment. Trust suppresses confirmation; it does not sandbox the script or prevent network/file access.

Follow the guide · Link to this answer

Can a macro automate the entire Mac?

Macros replay supported editor events. They do not record arbitrary windows, other applications or terminal sessions. Test a recorded sequence on disposable text first.

Follow the guide · Link to this answer

What happens if I run a selection command with nothing selected?

Selection input receives the whole document when no text is selected. Replace Selection output then replaces the whole document. Select disposable text before testing a transformation; only one command runs at a time.

Follow the guide · Link to this answer

Settings reference

Why is a theme locked?

Built-in themes cannot be edited directly. Duplicate as editable copy, change its colors, then choose Use This Theme to activate it.

Follow the guide · Link to this answer

Where did a file-tree menu action go?

Check Settings → File Tree and enable the action. Target type also affects availability. Reset to Defaults restores the shipped configuration.

Follow the guide · Link to this answer

How do I use MeatPad without a Dock icon?

Enable Menu bar only (hide Dock icon) in General settings. The Dock-click setting is disabled in that mode; the activation policy changes after the last window closes.

Follow the guide · Link to this answer

Data, privacy and backup

Where are my notes and boards stored?

Normally in ~/Library/Application Support/MeatPad. Settings → Privacy shows the active location and Reveal in Finder opens it. Relocated libraries can use a different root.

Follow the guide · Link to this answer

Does Export All Data include project folders?

It copies managed library folders, including Boards and their attachments, automation, themes and session.json. External project folders and every macOS preference are outside that export; back them up separately.

Follow the guide · Link to this answer

Does MeatPad sync my library to a cloud account?

MeatPad stores its library locally and does not upload it to a hosted account. Relocate changes the storage root; it is not a two-way sync service. Use a deliberate backup routine.

Follow the guide · Link to this answer

Does local storage mean no network activity?

Update checks use the network. Your terminal commands, Git remotes, opened links and configured scripts may also use it. Local language-server programs run on your Mac and follow their own configuration.

Follow the guide · Link to this answer

Can I undo Delete All Data?

It moves managed data to macOS Trash and quits after confirmation. Recover it before emptying Trash, or restore a verified backup. It does not erase external project folders.

Follow the guide · Link to this answer

Keyboard shortcuts

Why does a keyboard shortcut do nothing?

Check focus and context: project commands need a project, navigation needs server support, and file-tree bindings work while that menu is open. User command bindings may also clash with standard menu shortcuts.

Follow the guide · Link to this answer

Need a hand?

Contact MeatPad support. Include your app version, macOS version and the steps that led to the problem.