> 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/artigos-aprofundados/32-markdown-into-latex-with-style.md). # Markdown em LaTeX com estilo **Atualização pós-publicação** (13 de maio de 2017): Somos gratos a Vít Novotný, o autor/mantenedor do `markdown` pacote, por nos escrever com alguns comentários úteis sobre o artigo original. Temos o prazer de publicar esta versão atualizada, que leva em conta e inclui seus conselhos e sugestões. ### Introdução Há algum tempo, ficamos entusiasmados com o lançamento do [`pacote markdown`](http://www.ctan.org/pkg/markdown) que tornou possível escrever sintaxe markdown em documentos LaTeX — e celebramos isso com um artigo chamado [Como escrever em Markdown no Overleaf](/latex/overleaf-learn-latex-pt/artigos-aprofundados/30-how-to-write-in-markdown-on-overleaf.md) cujo objetivo era demonstrar parte da sintaxe suportada. **Lembre-se**: Você precisará compilar seus `.tex` arquivos com a `--shell-escape` opção para fazê-lo funcionar em instalações locais do LaTeX — o Overleaf faz isso por você (automaticamente). Tenha em mente que a maioria dos portais de submissão de periódicos não habilita `--shell-escape`—a menos que seja permitido enviar apenas o PDF final do seu manuscrito, seus arquivos LaTeX contendo markdown podem não compilar com sucesso quando processados pelo sistema de submissão da editora. Uma das ideias sugeridas no [artigo anterior](/latex/overleaf-learn-latex-pt/artigos-aprofundados/30-how-to-write-in-markdown-on-overleaf.md) é que uma combinação de markdown e LaTeX permite uma maravilhosa separação entre conteúdo e estilo. Os autores (especialmente os já familiarizados com markdown) teriam uma sintaxe muito mais sucinta para usar (com algumas ressalvas), ao mesmo tempo em que ainda teriam acesso a todas as maravilhas dos pacotes e modelos LaTeX para cuidar da estilização e da formatação. Isso [artigo anterior](/latex/overleaf-learn-latex-pt/artigos-aprofundados/30-how-to-write-in-markdown-on-overleaf.md) trouxe alguns exemplos de uso de markdown em [apresentações Beamer](https://www.overleaf.com/read/dnrwnjrpjjhw) e [pôsteres](https://www.overleaf.com/read/jtbgmmgqrqmh): hoje vamos olhar para possibilidades de estilo ainda mais divertidas e empolgantes! ### Usando markdown em modelos LaTeX estilizados Além dos exemplos acima, você pode usar markdown em quase todos os modelos. Aqui estão alguns exemplos rápidos: * O [livro laranja de Legrange](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) modelo * O [folheto inspirado em Tufte](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) modelo * Este [modelo de artigo muito bom](https://www.overleaf.com/read/xfsrpsmdtqvt) por Thiago Você pode notar que dois destes são modelos de artigo e um é um modelo de livro. O [`pacote markdown`](http://www.ctan.org/pkg/markdown) detecta se o `\chapter` comando está disponível para uso em um determinado documento LaTeX e fará com que o título de primeiro nível `markdown` seja renderizado para `\chapter` ou `\section` conforme apropriado. ### Folhetos rapidinhos: markdown + pocketmod Desde a época em que aprendi sobre markdown pela primeira vez, isso me pareceu uma forma rápida e conveniente de tomar notas: reflete como eu poderia estar rabiscando anotações em pedaços de papel ou em post-its — especialmente com a sintaxe de listas com marcadores e numeradas. Quando criei pela primeira vez o [modelo PocketMod](https://www.overleaf.com/read/nqbhpnrkskrx) em 2015, ansiava por uma forma de escrever markdown em LaTeX para que eu pudesse criar PocketMods *com* markdown porque parecia… apropriado. Anotar notas com uma sintaxe simples em pequenos livretos dobrados, mas com tipografia bonita — algumas pessoas se referem aos PocketMods como "zines" porque são pequenos livretos de 8 páginas que você pode fazer a partir de uma única folha de papel A4. E, de fato, foi possível! Isso torna relativamente fácil produzir rapidamente um [mini-livreto de planeador semanal](https://www.overleaf.com/read/zfzcxygqwqsq) ou um pequeno [livro de histórias ilustradas](https://www.overleaf.com/read/rppnsfgnrhsf). Sim, manteve minha filha entretida ver um livro de histórias feito a partir dos próprios desenhos dela… bem, por 10 minutos inteiros! O [`pacote markdown`](http://www.ctan.org/pkg/markdown) permite personalizar como cada sintaxe markdown é renderizada em LaTeX, então eu redefini a sintaxe padrão `![](img_file "caption")` para colocar a legenda abaixo do arquivo de imagem (sem qualquer prefixo "Figura" ou numeração) e depois inseri uma quebra de página. Isso torna ainda mais fácil fazer o livro de imagens. Aqui está um vídeo mostrando como dobrar o livrinho: {% embed url="" %} ### Folhetos de receitas simples Quando você pensa nisso, uma receita é composta por listas: uma lista de ingredientes, uma lista de instruções de preparação ou de cozimento e talvez uma lista de notas (tempo de cozimento, porções etc.). Então, em vez de escrever isto: ```latex \begin{enumerate} \item Primeiro faça isto \item Depois faça aquilo ... \end{enumerate} ``` Eu certamente apreciaria poder escrever isto: ``` #. Primeiro faça isto #. Depois faça aquilo ``` E o mesmo para os ingredientes: ``` - 2 ovos - uma pitada de sal ``` Então, para produzir facilmente uma receita rápida, podemos escrever isto: ``` # Ovos mexidos Tempo de cozimento : 5 minutos Serve : 1 ## Ingredientes - 4 ovos - 1 c. de chá de manteiga - 1/4 de chávena de leite - sal, pimenta (a gosto) ## Instruções #. Bata os ovos, o leite... #. Aqueça a manteiga na frigideira... #. ... ``` Hmm, isso parece promissor. Alguns de nós no Overleaf (e as nossas famílias) contribuíram com as suas receitas rápidas favoritas (ideais para cozinheiros de primeira viagem), e eu improvisei (perdoem o trocadilho) um [modelo de receita rápida](https://www.overleaf.com/read/gscqdhnwzsfg) que você pode escrever com markdown *e* e transformar num mini-livreto. [![A recipe booklet produced on Overleaf using markdown](/files/c02e5ed2ff3af3697c918443a1ad62c0e6ad2ad2)](https://www.overleaf.com/read/gscqdhnwzsfg) Agora vem outra parte divertida. Nos bastidores, isto ainda é LaTeX, por isso podemos continuar a estilizar os vários elementos — títulos de secções, listas com marcadores, fontes e assim por diante — usando o repertório habitual de truques do LaTeX. Foi então que me entusiasmei bastante e criei *três* "temas" para a `classe simple-recipe` ! ### Bónus 1: Algumas ressalvas ao usar o pacote markdown * O SyncTeX não vai funcionar perfeitamente. No Overleaf, isto significa que as operações "posição na pré-visualização" e "clicar na pré-visualização para ir para a fonte" não funcionarão nas `markdown` regiões. * `\\` perde o seu significado normal: o habitual "dois espaços seguidos de uma nova linha" `markdown` truque não funciona aqui porque os espaços finais serão removidos pelo analisador Lua, como documentado no [`markdown` documentação do pacote](http://texdoc.net/pkg/markdown). `\newline` vai funcionar, no entanto. * Tenha cuidado com múltiplos caracteres sublinhados na mesma linha — isso pode ser um problema se: * você estiver a trabalhar com muitos subscritos nas suas equações (dica: saia do ambiente `markdown` nesses casos); * você gosta de usar sublinhados nas suas chaves BibTeX. Você pode definir `underscores=false` com os ficheiros mais recentes `pacote markdown` para fazer os sublinhados de subscrito funcionarem, mas ainda assim não funcionará com sublinhados em chaves BibTeX. **Atualização** (13 de maio de 2017): Os sublinhados em chaves BibTeX funcionarão com `markdown` a partir da v2.5.2 — obrigado, Vít! * Você terá algumas dificuldades para mostrar um carácter hash literal porque nem mesmo `\#` vai funcionar! Normalmente, defino um novo comando e uso-o em vez disso. ### Bónus 2: Novas funcionalidades no pacote markdown atualizado `markdown` A v2.4 e as versões posteriores adicionaram suporte para alguma sintaxe realmente ótima: * **Sintaxe de nota de rodapé em linha**: `...^[esta é a nota de rodapé]` (requer a opção `inlineFootnotes` ) * **Citações:**`[@smith1990]` (requer a opção `opção de citações; também tenha cuidado com sublinhados nas suas chaves BibTeX!)` opção; também tenha cuidado com sublinhados nas suas chaves BibTeX!) * **Código delimitado**: Você pode usar tiles `~` ou backticks `` ` `` como delimitadores. ``` ~~~~ int main() { cout << "Olá, mundo!"; return 0; } ~~~~ ``` Se quiser usar estas novas funcionalidades, certifique-se de enviar versões atualizadas de `markdown.lua`, `markdown.tex` e `markdown.sty` para o seu projeto — ou pode simplesmente criar um novo projeto a partir de [este modelo](https://www.overleaf.com/read/whdrnpcpnwrm). --- # 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/artigos-aprofundados/32-markdown-into-latex-with-style.md?ask=&goal= ``` `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.