feat: add label option to macro syntax

Author: chhoumann

docs/docs/FormatSyntax.md

@@ -17,7 +17,7 @@ title: Format syntax
 | `{{LINKCURRENT}}`                          | A link to the file from which the template or capture was triggered (`[[link]]` format). When the append-link setting is set to **Enabled (skip if no active file)**, this token resolves to an empty string instead of throwing an error if no note is focused. |
 | `{{FILENAMECURRENT}}`                      | The basename (without extension) of the file from which the template or capture was triggered. Honors the same **required/optional** behavior as `{{LINKCURRENT}}` - when optional and no active file exists, resolves to an empty string. |
 | `{{MACRO:<MACRONAME>}}`                    | Execute a macro and write the return value here.                                                                                                                                                                                                                            |
-| `{{MACRO:<MACRONAME>\|<label>}}`           | Executes the macro but shows the label as the placeholder when the macro prompts you to choose an export from a script object. This is helpful when multiple macro calls show similar lists. |
+| `{{MACRO:<MACRONAME>\|label:<label>}}`           | Executes the macro but shows the label as the placeholder when the macro prompts you to choose an export from a script object. This is helpful when multiple macro calls show similar lists. You can also use the shorthand `{{MACRO:<MACRONAME>\|<label>}}`. |
 | `{{TEMPLATE:<TEMPLATEPATH>}}`              | Include templates in your `format`. Supports Templater syntax.                                                                                                                                                                                                                                                                                    |
 | `{{GLOBAL_VAR:<name>}}`                    | Inserts the value of a globally defined snippet from QuickAdd settings. Snippet values can include other QuickAdd tokens (e.g., `{{VALUE:...}}`, `{{VDATE:...}}`) and are processed by the usual formatter passes. Names match case‑insensitively in the token. |
 | `{{MVALUE}}`                               | Math modal for writing LaTeX. Use CTRL + Enter to submit. |                                                                                                                                                                                                                                                                         

src/constants.ts

@@ -38,7 +38,7 @@ export const FORMAT_SYNTAX: string[] = [
 	LINKCURRENT_SYNTAX,
 	FILENAMECURRENT_SYNTAX,
 	"{{macro:<macroname>}}",
-	"{{macro:<macroname>|<label>}}",
+	"{{macro:<macroname>|label:<label>}}",
 	"{{template:<templatepath>}}",
 	MATH_VALUE_SYNTAX,
 	SELECTED_SYNTAX,

src/gui/suggesters/formatSyntaxSuggester.ts

@@ -240,7 +240,7 @@ export class FormatSyntaxSuggester extends TextInputSuggest<string> {
 						(macroName) => `{{MACRO:${macroName}}}`
 					)
 				);
-				suggestions.push("{{MACRO:MyMacro|Label}}");
+				suggestions.push("{{MACRO:MyMacro|label:Label}}");
 			} else if (tokenDef.token === FormatSyntaxToken.VariableDate) {
 				// Add example suggestions for VDATE with and without default values
 				suggestions.push(

src/utils/macroSyntax.test.ts

@@ -0,0 +1,23 @@
+import { describe, expect, it } from "vitest";
+import { parseMacroToken } from "./macroSyntax";
+
+describe("parseMacroToken", () => {
+	it("returns null for empty input", () => {
+		expect(parseMacroToken("")).toBeNull();
+	});
+
+	it("parses shorthand labels", () => {
+		const parsed = parseMacroToken("MyMacro|Pick one");
+		expect(parsed).toEqual({ macroName: "MyMacro", label: "Pick one" });
+	});
+
+	it("parses label option", () => {
+		const parsed = parseMacroToken("MyMacro|label:Pick one");
+		expect(parsed).toEqual({ macroName: "MyMacro", label: "Pick one" });
+	});
+
+	it("ignores empty label option", () => {
+		const parsed = parseMacroToken("MyMacro|label:");
+		expect(parsed).toEqual({ macroName: "MyMacro", label: undefined });
+	});
+});

src/utils/macroSyntax.ts

@@ -12,9 +12,14 @@ export function parseMacroToken(raw: string): ParsedMacroToken | null {
 	}
 
 	const macroName = raw.slice(0, pipeIndex).trim();
-	const label = raw.slice(pipeIndex + 1).trim();
+	const labelPart = raw.slice(pipeIndex + 1).trim();
 	if (!macroName) return null;
 
+	let label = labelPart;
+	if (labelPart.toLowerCase().startsWith("label:")) {
+		label = labelPart.slice("label:".length).trim();
+	}
+
 	return {
 		macroName,
 		label: label || undefined,