> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/overleaf-learn-latex-pt/perguntas-e-respostas/75-inserting-emojis-in-latex-documents-on-overleaf.md).

# Inserir emojis em documentos LaTeX no Overleaf

*Nota: O `[twemojis](https://www.ctan.org/pkg/twemojis)` pacote não está incluído em* [*TeX Live*](/latex/overleaf-learn-latex-pt/ficheiros-de-classe/02-overleaf-and-tex-live.md)*, e, por isso, não está disponível para uso no Overleaf.*

## Carateres emoji e o editor do Overleaf

O Overleaf não pode armazenar ficheiros que contenham [caracteres NUL](https://en.wikipedia.org/wiki/Null_character) nem editar ficheiros que contenham carateres fora do [Plano Multilíngue Básico (BMP)](https://en.wikipedia.org/wiki/Plane_\(Unicode\)).

O Unicode atribuiu muitos carateres emoji a pontos de código fora do Plano Multilíngue Básico: são codificados no [Plano 1](https://en.wikibooks.org/wiki/Unicode/Character_reference/1F000-1FFFF), o que significa que os seus pontos de código estão no intervalo U+10000–U+1FFFF, especificamente U+1F000–U+1FFFF. Isto tem uma consequência importante para qualquer pessoa que queira copiar e colar carateres emoji no editor do Overleaf. Atualmente, o editor de texto do Overleaf só consegue lidar com carateres dentro do Plano Multilíngue Básico, embora esperemos que futuras atualizações introduzam suporte para carateres não-BMP.

Se colar um emoji como 😀, ou qualquer outro carater não-BMP, no editor do Overleaf, ele será convertido nos carateres ��. No entanto, pode carregar ficheiros de texto que contenham sequências UTF-8 não-BMP: não poderão ser editados no editor do Overleaf, mas pode inserir esses ficheiros no seu documento usando os comandos apropriados de inclusão de ficheiros LaTeX.

Como mostrado nos exemplos abaixo, pode inserir emoji usando tipos de letra e comandos adequados fornecidos por pacotes LaTeX.

## Emojis monocromáticos

Você pode usar o `\symbol` ou `\char` comando em conjunto com `fontspec`, [XƎLaTeX ou LuaLaTeX](/latex/overleaf-learn-latex-pt/base-de-conhecimento/026-changing-compiler.md) e um tipo de letra adequado. Por exemplo, sem usar o [`emoji` pacote](https://ctan.org/pkg/emoji?lang=en), ainda pode inserir emojis monocromáticos com o tipo de letra Symbola:

```latex
Folhas a cair: {\fontspec{Symbola}\symbol{"1F343}}

ou

Folhas a cair: {\fontspec{Symbola}\char"1F343}
```

[Abra este exemplo de emoji monocromático no Overleaf](https://www.overleaf.com/docs?engine=lualatex\&snip_name=Monochrome+emoji\&snip=%5Cdocumentclass%5B12pt%5D%7Barticle%7D%0A%5Cusepackage%7Bfontspec%7D%0A%5Cusepackage%7Bparskip%7D%0A%0A%5Cbegin%7Bdocument%7D%0AFalling+leaves%3A+%7B%5Cfontspec%7BSymbola%7D%5Csymbol%7B%221F343%7D%7D%0A%0Aor%0A%0AFalling+leaves%3A+%7B%5Cfontspec%7BSymbola%7D%5Cchar%221F343%7D%0A%5Cend%7Bdocument%7D)

Isto dará o resultado ![Symbola-falling-leaves.png](/files/292dcd4237a1d083fe044a07e8509c9a5bfb6892)

Pode procurar os pontos de código dos emojis em [esta página web](https://unicode.org/emoji/charts/emoji-list.html).

## Emojis a cores

Se quiser usar emojis a cores, dê uma vista de olhos ao `[emoji](https://www.ctan.org/pkg/emoji)` pacote, que utiliza o motor de composição de texto LuaLaTeX + HarfBuzz para aceder corretamente aos tipos de letra de emojis a cores. Terá de [alterar o compilador do seu projeto para LuaLaTeX](/latex/overleaf-learn-latex-pt/base-de-conhecimento/026-changing-compiler.md). Em seguida, pode carregar o `emoji` pacote e escrever `\emoji{leaves}`.

```latex
\documentclass[12pt]{article}
\usepackage{emoji}

\begin{document}

Estes são emojis a cores usando o pacote \texttt{emoji} e LuaLaTeX:
\emoji{leaves}
\emoji{rose}

Pode usar modificadores de emoji:
\emoji{woman-health-worker-medium-skin-tone}
\emoji{family-man-woman-girl-boy}
\emoji{flag-malaysia}
\emoji{flag-united-kingdom}

\end{document}
```

[Veja este exemplo em tempo real no Overleaf](https://www.overleaf.com/docs?engine=lualatex\&snip_name=colour+emojis+using+LuaLaTeX\&snip=%5Cdocumentclass%5B12pt%5D%7Barticle%7D%0A%5Cusepackage%7Bemoji%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0AThese+are+colour+emojis+using+the+%5Ctexttt%7Bemoji%7D+package+and+LuaLaTeX%3A%0A%5Cemoji%7Bleaves%7D%0A%5Cemoji%7Brose%7D%0A%0AYou+can+use+emoji-modifiers%3A%0A%5Cemoji%7Bwoman-health-worker-medium-skin-tone%7D%0A%5Cemoji%7Bfamily-man-woman-girl-boy%7D%0A%5Cemoji%7Bflag-malaysia%7D%0A%5Cemoji%7Bflag-united-kingdom%7D%0A%0A%5Cend%7Bdocument%7D)

![NotoEmoji-demo.png](/files/9c68ea190a07611be1b566237e7b85def4908587)

Pode procurar os nomes no Unicode CLDR (Common Locale Data Repository) [aqui](https://unicode.org/emoji/charts/emoji-list.html), mas lembre-se de substituir os espaços nos nomes por hífenes. Em alternativa, pode consultar [o `emoji` documentação do pacote](http://texdoc.net/pkg/emoji) o próprio.

## Escolher um tipo de letra de emoji diferente

No Overleaf, o tipo de letra de emoji predefinido é Noto Color Emoji. Pode selecionar um tipo de letra de emoji diferente:

```latex
\setemojifont{TwemojiMozilla}
```

![TwemojiMozilla-demo.png](/files/e2e3eda07dd538e171a5e216104c3f9892b12b18)

```latex
\documentclass[12pt]{article}
\usepackage{emoji}

\begin{document}
\setemojifont{TwemojiMozilla}
Estes são emojis a cores usando o pacote \texttt{emoji} e LuaLaTeX:
\emoji{leaves}
\emoji{rose}

Pode usar modificadores de emoji:
\emoji{woman-health-worker-medium-skin-tone}
\emoji{family-man-woman-girl-boy}
\emoji{flag-malaysia}
\emoji{flag-united-kingdom}

\end{document}
```

[Abra este exemplo TwemojiMozilla no Overleaf](https://www.overleaf.com/docs?engine=lualatex\&snip_name=Colour+emojis+using+the+TwemojiMozilla+font+and+LuaLaTeX\&snip=%5Cdocumentclass%5B12pt%5D%7Barticle%7D%0A%5Cusepackage%7Bemoji%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Csetemojifont%7BTwemojiMozilla%7D%0AThese+are+colour+emojis+using+the+%5Ctexttt%7Bemoji%7D+package+and+LuaLaTeX%3A%0A%5Cemoji%7Bleaves%7D%0A%5Cemoji%7Brose%7D%0A%0AYou+can+use+emoji-modifiers%3A%0A%5Cemoji%7Bwoman-health-worker-medium-skin-tone%7D%0A%5Cemoji%7Bfamily-man-woman-girl-boy%7D%0A%5Cemoji%7Bflag-malaysia%7D%0A%5Cemoji%7Bflag-united-kingdom%7D%0A%0A%5Cend%7Bdocument%7D)

## Leitura adicional

* [O `emoji` pacote](https://www.ctan.org/pkg/emoji)
* [Lista de nomes CLDR de emoji e pontos de código](https://unicode.org/emoji/charts/emoji-list.html)
* [Alterar o compilador do seu projeto no Overleaf](/latex/overleaf-learn-latex-pt/base-de-conhecimento/026-changing-compiler.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/overleaf-learn-latex-pt/perguntas-e-respostas/75-inserting-emojis-in-latex-documents-on-overleaf.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
