SETUP · GOOGLE DOCS + CHROME
Get started with MathDocs
Choose the part you already have. We’ll guide you through the rest.
The complete MathDocs experience uses both parts. Have neither? Install the Docs add-on first, then the Chrome extension. Have one already? Choose the other part above.
From the Docs add-on to the Chrome extension
Part 2 · math fields and shortcuts on the document sheet
The Docs part provides document access and saving. Install the Chrome part to complete MathDocs with editable fields directly on the page and keyboard shortcuts.
- Use Chrome on your computer. Open the Chrome profile you use for Google Docs™.
- Install MathDocs CAS from the Chrome Web Store. Open the MathDocs CAS Chrome Web Store listing. Choose Add to Chrome → Add extension. Check publication status if you cannot find it.
- Optionally pin the MathDocs icon. Open the extensions menu by the address bar and select the pin next to MathDocs CAS.
- Reload your Google document. Click in the document text where the formula belongs.
- Open the math field. Windows: Ctrl + M. Mac: Option + M. You can also use the MathDocs icon or the ∑ button in the document.
Ready: a MathDocs field appears on the document sheet. Continue with your first calculation.
From the Chrome extension to the Docs add-on
Required to save formulas from the Chrome field
The Chrome extension provides the field and shortcuts. The Docs add-on gives MathDocs access to insert and edit formulas in the document you are working on.
- Open a Google document you can edit. Use the Google account that should have MathDocs installed.
- Choose Extensions → Add-ons → Get add-ons. Find MathDocs CAS in Google Workspace™ Marketplace. Check the MathDocs CAS name and verify that you are on the official Google Workspace™ Marketplace listing. Check publication status if it is missing.
- Choose Install → Continue. Select the same Google account as your document, read the permissions and authorize in Google’s dialog.
- Reload the document and open the editor once. Choose Extensions → MathDocs CAS → Open editor. Complete any Google authorization prompt.
- Choose how to work. Use the menu editor, or close it, click in the document text and open the Chrome field with Ctrl + M on Windows or Option + M on Mac.
Ready: the menu editor opens and a saved result appears in the document. The Chrome shortcut works when the extension is also installed in the active Chrome profile.
Your first calculation
- Type
1/2and press Space. Then type+1/3and press Space again. - Press Enter. The result is 5/6, displayed as a fraction on a new line in the editor.
- Press Ctrl + Enter on Windows or Cmd + Enter on Mac. Wait for the formula and result to be saved in the document; saving requires a Google connection.
- Select the inserted formula image and open MathDocs from the menu again. Change
1/3to1/6, calculate and save. The result should now be 2/3.
| Action | Windows | Mac |
|---|---|---|
| Open field | Ctrl + M | Option + M |
| Calculate in field | Enter or Ctrl + M | Enter or Option + S |
| Insert in document | Ctrl + Enter | Cmd + Enter |
| Plot | Alt + P | Option + P |
Option + M focuses an open field on Mac. Ctrl/Cmd + P still prints. Without the Chrome extension, open the editor from the Docs menu; Enter and Ctrl/Cmd + Enter work there too.
If something is missing
I have the Chrome extension, but cannot save
Follow the Docs guide and open the menu editor once using the same account as the document. You need editing access. If a save cannot be confirmed, check the document before retrying and keep your draft.
MathDocs is missing from the Docs menu
Reload the document and check your Google account. Look under Extensions → Add-ons → Manage add-ons. If you are editing a Word file directly, convert it to Google Docs™ format to use Editor add-ons.
The shortcut does not open the field
Use Chrome on a computer, check that MathDocs is enabled in the current Chrome profile and reload the document after installation. Click in the document text. Also try the ∑ button or the MathDocs icon.
My school or workplace blocks installation
Ask your administrator to allow MathDocs CAS in both Google Workspace™ Marketplace and the Chrome Web Store for the complete MathDocs workflow. The two stores can have different administrator policies.
Do I need to copy code into Apps Script?
Regular users install the published add-on from Marketplace. Manually copying Apps Script files is for development and separately arranged test installations. This guide requires no code copying.
Do my collaborators need MathDocs?
Anyone with document access can see and print saved formula images. Editing their mathematical source requires the Docs add-on. The complete on-page editing workflow also uses the Chrome extension. Formulas are images with editing data, not native Google equation fields.
Help and contact
Email contact@skaybase.com with your browser, operating system, MathDocs version and the step that failed. Use a harmless sample expression.
Google’s instructions: Install a Chrome extension · Install a Docs add-on.
Manage and delete your data
In Docs add-on build 2.0.10 and later, save and close your math field, then open Extensions → MathDocs CAS → Privacy and data. Confirm the choice and select Delete my settings for this document. A bound test installation uses the MathDocs menu instead.
This deletes only your private Google-stored variables, session and settings for the open document. Shared variables, document formulas and other users' settings are kept. Repeat in other documents if needed. Older builds do not have this menu yet.
Local drafts and cached images are separate: removing the Chrome extension clears its extension storage. For the standalone editor, clear browser site data for the relevant Google Apps Script™ HTML-service origin. Saved formulas and metadata in the Google document follow the document's own controls. Read the full privacy policy.