Allow opting out extension name part in `format-link` text when customizing content

It seems not possible today to really customize fully the text as the extension name will always be appended in parenthesis if the format comes from an extension

https://github.com/quarto-dev/quarto-cli/blob/9724c3dd403d4e723bcb0a7e7bef6e49d23a353a/src/format/html/format-html-links.ts#L95-L104

Should we add a new option to allow overriding this ?

Or should just an example showing the href form be used instead for those situation ?
https://quarto.org/docs/output-formats/html-multi-format.html#specifying-formats-to-link

To think about.

Discussed in https://github.com/quarto-dev/quarto-cli/discussions/10270

^{Originally posted by aaronschiff July 11, 2024}

Description

This is pretty minor but ... I care about details 😅

I have a project that produces html and pdf output via a custom Typst template. I have used format-link in the project's _quarto.yml file to change the way the link to the Typst output is displayed in the html table of contents, but it still includes the template's name in brackets. Is there a way to remove the template name?

Here is the relevant part of the project _quarto.yml, where my template is called "cheatsheet":

format:
  html:
    toc: true
  cheatsheet-typst:
    toc: false

format-links:
  - html
  - format: cheatsheet-typst
    text: PDF
    icon: file-pdf

Here's link in the rendered html:

I'd like it to just say "PDF".

Start in src/format/html/format-html-links.ts around lines 95-104, then review the format-links example in the HTML multi-format documentation. Determine how customized text for extension formats should suppress the appended extension name, and verify that the resulting link displays only the configured text such as “PDF”.