> For the complete documentation index, see [llms.txt](https://quarkdown.com/wiki/llms.txt).

# Emojis

Quarkdown documents support emojis through direct insertion or shortcode functions.

## Direct insertion

You can insert emoji characters directly into your source code:

> **Example 1**
> 
> ```markdown
> Quarkdown's logo is not a planet 🪐  
> I love Quarkdown! 😍
> ```
> 
> Quarkdown’s logo is not a planet 🪐  
> I love Quarkdown! 😍

## Shortcode function

You can use the `.emoji`  function with a shortcode:

> **Example 2**
> 
> ```markdown
> Quarkdown's logo is not a planet .emoji {ringed-planet}  
> I love Quarkdown! .emoji {heart-eyes}
> ```
> 
> Quarkdown’s logo is not a planet 🪐  
> I love Quarkdown! 😍

> During compilation, the first call to `.emoji` in a document loads the entire emoji set, which may slightly increase compilation time. Subsequent calls are faster.

For a complete list of supported shortcodes, refer to the [Emoji Cheat Sheet](https://quarkdown.com/docs/emoji-list/).

### Variants

| Type | Result | Code |
| --- | :---: | --- |
| Simple shortcode | 😉 | `.emoji {wink}` |
| One skin tone | 👋🏾 | `.emoji {waving-hand~medium-dark}` |
| Two skin tones | 🧑🏼‍🤝‍🧑🏾 | `.emoji {people-holding-hands~medium-light,medium-dark}` |

### Credits

Shortcode support is provided by [Emoji.kt](https://github.com/kosi-libs/Emoji.kt). Thanks!