User Manual

Detailed Guide — v1.0.0

Welcome to Macro Text! This extension is designed to save you time by automatically expanding short, memorable text "shortcuts" into larger blocks of text, emails, or code.

This manual will teach you how to use the core features of the extension, from basic text expansions to advanced dynamic macros.

1. Creating Your First Snippet

A snippet is composed of two main parts:

How to use it:

Whenever you are typing in any text box in your browser (like an email, a chat window, or a document), simply type your shortcut (/greet), and it will instantly transform into your full content!

2. Advanced Macros (Dynamic Content)

Macro Text isn't just for static text. You can use special "Macros" inside your snippet content to make them dynamic and interactive.

Cursor Placement: {cursor}

By default, after a snippet expands, your text cursor is placed at the very end. If you want to automatically place the cursor somewhere in the middle of the text so you can start typing immediately, use the {cursor} macro.

Example:

Content: Best regards, {cursor} - The Support Team

Result: After expansion, your typing cursor will be right before the hyphen, ready for you to type a name.

Dates and Times: {time: ...}

You can automatically insert the current date or time using the {time: FORMAT} macro.

Common Formats:

Time Shifting (Future/Past Dates)

You can add a "shift" parameter to calculate future or past dates automatically! Use D for Days, W for Weeks, M for Months, and Y for Years.

Math Calculations: {= ... }

You can have the extension evaluate simple math equations for you on the fly.

Example:

Content: The total cost is ${= 150 * 1.2 }

Result: The total cost is $180

3. Interactive Forms (Fill-in-the-Blanks)

If you have a template where certain names, dates, or options change every time you use it, you can use Form Macros. When you trigger a snippet containing a form macro, a small window will pop up asking you to fill in the blanks before the text is inserted.

Text Inputs: {formtext: ...}

Use this when you need to type a custom word or phrase into your template.

Syntax: {formtext: name=Your Label; default=Optional Default Text}

Example Content:

Hi {formtext: name=Customer Name}, thank you for purchasing the {formtext: name=Product; default=Standard Package}.

When you type this shortcut, a box will appear asking for the "Customer Name" and the "Product" before inserting the text.

Dropdown Menus: {formmenu: ...}

Use this when you want to choose from a predefined list of options.

Syntax: {formmenu: name=Your Label; option1; default=option2; option3}

Example Content:

The current status of your ticket is: {formmenu: name=Status; Pending; default=In Progress; Resolved}.

When you type this shortcut, a dropdown menu will appear allowing you to select one of the three statuses.

4. Organizing and Sharing

↑