Snip for MacOS - Quickstart guide

This is a brief guide for getting up and running with Snip on your Mac computer. It will cover all the main features of the app and how they work.

Install Snip

If you haven’t already, download the MacOS Snip app either by clicking here (and your download will start automatically), or downloading from the Mac App Store. If you run in to any problems during the installation process, check out the step-by-step installation guide.

I’ve started the app, where is it?

Snip is a system tray app, which means you will find it in your system tray at the top right of your screen, rather than your Dock.
Mathpix shows in the system tray

Logging in with your Mathpix Snip account

Before you can start using the app, you must Log in with your Mathpix Snip account. Don’t have an account yet? You can sign up in the app or at accounts.mathpix.com. A full guide for creating your account can be found here.
Enter the email and password (case senstitive) you signed up with to Log in. If the Login button is disabled that means you haven’t entered a proper email or password–double check them! If you forgot your password and need to reset it, click Forgot? and a reset password link will be sent to your email.
Once you have entered your email address and password and successfully logged in, you will see your Snip List. If this is your first time using the app, the List will be empty and instead you will see this message Click here to take a snip! Or enter CTRL+⌘+M on your keyboard.
Empty list view

Shortcuts

CTRL+⌘+M: Take a Snip (launches the screenshot)
CTRL+⌘+O: Open the app window
CTRL+⌘+L: Open the Snip editor
Note that the above shortcuts can be changed at any time by going to Preferences > General
When editing or writing a Snip, use CTRL+ENTER to Save and ENTER to create a new line.

Taking a Snip

There are 2 ways to take a Snip:
  1. Click the Screenshot button in the top left corner of the app.
Screenshot button
  1. Enter the keyboard shortcut (CTRL+⌘+M) anytime the app is running on your computer.
After either clicking the Screenshot button or entering the keyboard shortcut, your screen will turn gray and you will need to click and drag your cursor to capture the desired area of your screen.
Didn’t mean to take a Snip? You can exit the screenshot mode by clicking once or hitting esc on your keyboard.

Syncing a Snip

All Snips taken from your account will sync automatically with any Snip app that you are logged into with the same account. Waiting for a Snip to sync? You can force an update by clicking the Sync button on the top right:
Syncing

Using a Snip result

Snip gives many different formats of results:
  • LaTeX (best for LaTeX editors)
  • Mixed text/LaTeX (best for Markdown editors)
  • PNGs (best for WYSIWYG editors)
  • Image URLs (best for HTML pages like blogs)
Text and LaTeX formats can be easily copied to your clipboard by toggling between the formats with your keyboard arrow keys. Whichever format row is selected will be copied to your clipboard automatically, so all you need to do is paste. You can customize which text and LaTeX rows appear in the app or your desired LaTeX delimeters by going to Preferences > Formatting.
You can copy or open a PNG format of either the original image or of the rendered LaTeX by clicking the buttons beneath the displayed image. Clicking Copy PNG automatically copies the image to your clipboard, while Open PNG will open the file in Preview.
Image URL formats can be found by navigating to the URLs tab:
URLs tab
There are 3 image URL formats:
  • URL (best for sharing images in messaging & documentation tools)
  • Markdown link (best for Markdown editors)
  • HTML <img> tag (best for websites)
Image URL formats
Just like the LaTeX and text format rows, whichever row is selected will be copied automatically to your clipboard.

Editing a Snip

Did your Snip result come back not quite right? You can edit the source to make it perfect!
First, click the Edit button (it looks like a pen) on your desired format row. (NOTE: if you edit the text mode (second) row, you will lose the math mode rows)
Edit button
This will open the Snip editor:
Editing a Snip
Make your changes in text box, you will see the changes render instantly in the preview above. Once you have your desired result, click Save:
Save your changes
Your Snip will update instantly and the updated result will be copied to your clipboard!
Updated Snip

Writing a Snip

Only available in Snip for Mac, we have an additional way of creating a Snip–by writing the Markdown or LaTeX directly. This is a convenient feature for users who need an image outputs (PNG or image URL) from raw LaTeX.
Click on the pen icon to open the Snip Editor page. Here you can toggle between Markdown or LaTeX, and start writing your Snip. Once you click save, a new Snip will be created. Note that this Snip will have no “original image”, since it has been created from text.
Editor mode in Snip

Deleting a Snip

You can delete an individual Snip from that Snip’s result page:
Delete an individual Snip
You can delete all of your Snips from your Snip List page:
Deleting all Snips
When you click the delete all Snips button, you will be asked to confirm that you want to delete all of your Snips (since this is an irreversible action). Click the Delete All Snips button to confirm, or the X to cancel.
Confirm delete all

Changing your settings

To access the app Preferences, click on the Settings wheel at the top right corner of the app, then choose Preferences from the menu:
Preferences
Go to Preferences > General to customize:
  • all keyboard shortcuts
  • if you want Snip to start at Login
General Preferences
Go to Preferences > Formatting to customize:
  • which format rows display in your app
  • your desired math mode LaTeX delimiters
  • whether or not to include extra spaces in your LaTeX
Formatting Preferences

Quitting Snip

You can quit Snip at any time by clicking on the Settings wheel to open the menu, and then choosing Quit. You can also enter ⌘+Q on your keyboard whenever the app is active to quit.