Release-note tryout links use a backtick-wrapped inline-code shorthand, without conditional comments:

The syntax is `try(<tryout-id>,<link-text>)`. The first argument is a stable registered tryout ID, not a command ID. The required link text is presentation only; all executable behavior and availability checks remain in installed code. Surrounding argument whitespace is trimmed. The first comma separates the ID from the label, and the final closing parenthesis ends the token, so labels can contain commas and parentheses. Labels are literal text, not Markdown or HTML.

Only a complete inline-code token is recognized. Bare text, code blocks, and code inside links or raw HTML remain noninteractive. Malformed shorthand stays literal code; a valid but unknown ID shows the existing unavailable-example explanation. Renderers without tryout support display the shorthand as literal inline code.

Use **Developer: Copy Feature Example Link** to produce the shorthand with the installed title as its initial label. The command chooses a longer backtick delimiter when the title contains backticks. Authors may edit the label without changing the registered behavior.

Existing encoded command links remain supported and retain their product-generated `Try This: <title>` labels:

For manual validation, add the shorthand to [releaseNotesTryouts.md](test/browser/fixtures/releaseNotesTryouts.md), open that file, and run **Developer: Open Current File as Release Notes**.

import { appendEscapedMarkdownInlineCode } from '../../../../base/common/htmlContent.js';

await clipboardService.writeText(appendEscapedMarkdownInlineCode(`try(${scenario.id},${scenario.tryout.title})`));

The same example can use different shorthand labels while a legacy link keeps its product-generated label:

[Legacy Smart Diff Example](command:workbench.action.onboarding.tryFeature?%5B%22editor.smart-diff%22%5D)

Malformed shorthand remains literal code: `try(editor.smart-diff,)`. A well-formed unknown ID has an inert explanation:

import { IClipboardService } from '../../../../../platform/clipboard/common/clipboardService.js';

import { IQuickInputService, IQuickPickItem } from '../../../../../platform/quickinput/common/quickInput.js';

import { IOnboardingTryoutScenario, IOnboardingTryoutService, onboardingTryoutPresentationRegistry, RUN_ONBOARDING_TRYOUT_COMMAND_ID } from '../../common/onboardingTryout.js';

suite('Copy feature example link', () => {

const store = ensureNoDisposablesAreLeakedInTestSuite();

let instantiation: TestInstantiationService;

let scenarios: Map<string, IOnboardingTryoutScenario>;

let copied: string[];

let items: readonly IQuickPickItem[];

let selection: 'first' | 'cancel' | 'remove';

function register(id: string, title: string): void {

scenarios.set(id, {

id,

trigger: { kind: 'command', commandId: RUN_ONBOARDING_TRYOUT_COMMAND_ID },

presentation: { kind: 'test', payload: {} },

tryout: { title, description: 'A local description.' },

});

}

setup(() => {

instantiation = store.add(new TestInstantiationService());

scenarios = new Map();

copied = [];

items = [];

selection = 'first';

register('sample', 'Local Example');

register('hidden', 'Hidden Example');

instantiation.stub(IOnboardingTryoutService, {

getTryouts: () => [...scenarios.values()],

getTryout: id => scenarios.get(id),

getAvailability: id => id === 'hidden' ? { kind: 'hidden' } : { kind: 'ready' },

run: () => assert.fail('Copying a link must not run the example'),

});

instantiation.stub(IClipboardService, { writeText: async text => { copied.push(text); } });

instantiation.stub(IQuickInputService, {}, 'pick', async (choices: readonly IQuickPickItem[]) => {

items = choices;

if (selection === 'remove') {

scenarios.delete('sample');

}

return selection === 'cancel' ? undefined : choices[0];

});

});

teardown(() => sinon.restore());

async function copy(): Promise<void> {

await instantiation.invokeFunction(CommandsRegistry.getCommand('developer.onboarding.copyTryoutLink')!.handler);

}

for (const [title, markdown] of [

['Local Example', '`try(sample,Local Example)`'],

['Compare A, B (Read-Only) & <C>', '`try(sample,Compare A, B (Read-Only) & <C>)`'],

['Compare `model` and ``provider``', '```try(sample,Compare `model` and ``provider``)```'],

]) {

test(`copies shorthand with the installed title: ${title}`, async () => {

register('sample', title);

await copy();

assert.deepStrictEqual({

copied,

items: items.map(item => ({ label: item.label, description: item.description, detail: item.detail })),

}, {

copied: [markdown],

items: [{ label: title, description: 'sample', detail: 'A local description.' }],

});

});

}

for (const result of ['cancel', 'remove'] as const) {

test(`does not overwrite the clipboard when selection ends with ${result}`, async () => {

selection = result;

await copy();

assert.deepStrictEqual(copied, []);

});

}

localize('releaseNotes.help.tryouts', "Feature example links may use custom labels and open locally registered examples. Reading, hovering, or focusing a link does not run it. If an example is unavailable, its explanation and any available setup action appear beside it. Setup does not automatically run the example."),

const tryoutCodeSpans = new WeakSet<marked.Tokens.Codespan>();

const renderCodeSpan = simpleSettingRenderer.getCodeSpanRenderer();

tokenizer: {

codespan(source) {

const token = marked.Tokenizer.prototype.codespan.call(this, source);

if (token && !this.lexer.state.inLink && !this.lexer.state.inRawBlock) {

tryoutCodeSpans.add(token);

}

return token;

},

},

codespan: token => (tryoutCodeSpans.has(token) ? tryouts?.renderCodeSpan(token.text) : undefined) ?? renderCodeSpan(token),