Font Awesome Quarto Extension

This extension allows you to use font-awesome icons in your Quarto HTML and PDF documents. It provides an {{< fa >}} shortcode:

Mandatory <icon-name>:
```
{{< fa <icon-name> >}}
```
Optional <group>, <size=...>, <title=...> and <label = ...>:
```
{{< fa <group> <icon-name> <size=...> <title=...> <label=...>}}
```
- group defaults to solid.
- size usage is detailed in https://github.com/quarto-ext/fontawesome#sizing-icons
- title is used only in HTML format to set the title attribute on the <i> element.
- label is used only in HTML format to set aria-label attribute. If unset, the icon-name is used.

For example:

Shortcode	Icon
`{{< fa thumbs-up >}}`
`{{< fa solid thumbs-up >}}`
`{{< fa regular thumbs-up >}}`
`{{< fa folder >}}`
`{{< fa regular folder >}}`
`{{< fa heart >}}`
`{{< fa regular heart >}}`
`{{< fa chess-pawn >}}`
`{{< fa brands bluetooth >}}`
`{{< fa brands twitter size=2xl >}}`
`{{< fa brands github size=5x >}}`
`{{< fa battery-half size=Huge >}}`
`{{< fa envelope title="An envelope" >}}`
`{{< fa envelope title="An envelope" label="custom aria-label" >}}` (HTML only)

Note that the icon sets are currently not perfectly interchangeable across formats:

html uses FontAwesome 6.7.2 from <https://github.com/FortAwesome/Font-Awesome
pdf uses the fontawesome6 package, based on FontAwesome 6.7.2 too.
Other formats are currently not supported, but PRs are always welcome!

Available Icons Reference

Below is a comprehensive list of available Font Awesome 6.7.2 icons organized by category.

Solid Icons (Default)

These icons work without specifying a group:

Icon	Name	Icon	Name	Icon	Name
	`house`		`heart`		`star`
	`user`		`check`		`xmark`
	`magnifying-glass`		`envelope`		`phone`
	`calendar`		`clock`		`location-dot`
	`camera`		`file`		`folder`
	`trash`		`download`		`upload`
	`pencil`		`pen`		`print`
	`share`		`link`		`lock`
	`bell`		`gear`		`wrench`
	`plus`		`minus`		`circle-info`
	`circle-question`		`triangle-exclamation`		`ban`
	`thumbs-up`		`thumbs-down`		`comment`
	`book`		`bookmark`		`flag`
	`globe`		`cloud`		`fire`
	`bolt`		`sun`		`moon`
	`music`		`image`		`video`
	`shopping-cart`		`credit-card`		`gift`
	`truck`		`plane`		`car`
	`laptop`		`mobile`		`tablet`
	`database`		`server`		`wifi`

Arrows & Navigation

Icon	Name	Icon	Name	Icon	Name
	`arrow-up`		`arrow-down`		`arrow-left`
	`arrow-right`		`chevron-up`		`chevron-down`
	`chevron-left`		`chevron-right`		`angles-up`
	`angles-down`		`angles-left`		`angles-right`
	`circle-arrow-up`		`circle-arrow-down`		`circle-arrow-left`
	`circle-arrow-right`		`rotate`		`rotate-right`

User & People

Icon	Name	Icon	Name	Icon	Name
	`user`		`users`		`user-plus`
	`user-minus`		`user-check`		`user-xmark`
	`user-gear`		`user-tie`		`user-group`
	`user-graduate`		`user-doctor`		`user-nurse`

Charts & Data

Icon	Name	Icon	Name	Icon	Name
	`chart-line`		`chart-bar`		`chart-pie`
	`chart-area`		`chart-column`		`chart-simple`

Tech & Code

Icon	Name	Icon	Name	Icon	Name
	`code`		`terminal`		`bug`
	`laptop-code`		`code-branch`		`code-commit`
	`code-merge`		`code-pull-request`		`cube`

Brands (use `brands` group)

Icon	Name	Icon	Name	Icon	Name
	`github`		`gitlab`		`twitter`
	`facebook`		`linkedin`		`youtube`
	`instagram`		`reddit`		`discord`
	`slack`		`python`		`java`
	`js`		`react`		`node-js`
	`docker`		`apple`		`windows`
	`linux`		`android`		`chrome`
	`firefox`		`microsoft`		`google`

Complete Icon List

For a complete searchable list of all 2,000+ icons, visit the Font Awesome Icon Gallery.

Usage tips:

Most icons work without a group prefix: {{< fa icon-name >}}
Brand icons require the brands group: {{< fa brands icon-name >}}
Regular icons can use the regular group: {{< fa regular icon-name >}}
Solid icons (default) can optionally use solid group: {{< fa solid icon-name >}}