<meta name="description" content="Guia de Referência Completo de Markdown. Guia abrangente com exemplos práticos e dicas. Ferramentas gratuitas incluídas."> <link rel="canonical" href="https://txt-tool.com/pt/blog/markdown-cheat-sheet.html"> <meta property="og:title" content="Markdown Cheat Sheet: Complete Reference Guide"> <meta property="og:description" content="Markdown Cheat Sheet: Complete Reference Guide. Free guide with examples."> <meta property="og:url" content="https://txt-tool.com/pt/blog/markdown-cheat-sheet.html"> <meta property="og:type" content="article"> <meta name="twitter:card" content="summary_large_image"> <link rel="stylesheet" href="/css/style.css?v=20260327c"> <script src="/js/theme.js"></script> <script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-6478776854131333" crossorigin="anonymous"></script> <link rel="icon" type="image/svg+xml" href="/favicon.svg"> <script type="application/ld+json">{"@context": "https://schema.org", "@type": "BlogPosting", "headline": "Markdown Cheat Sheet", "datePublished": "2026-03-16", "dateModified":"2026-03-31", "author": {"@type": "Organization", "name": "TxtTool"}, "publisher": {"@type": "Organization", "name": "TxtTool"}, "description": "Markdown Cheat Sheet: Complete Reference Guide. Comprehensive guide with practical examples and tips. Free tools included.", "mainEntityOfPage": {"@type": "WebPage", "@id": "https://txt-tool.com/blog/markdown-cheat-sheet.html"}}</script> <script type="application/ld+json">{"@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{"@type": "ListItem", "position": 1, "name": "Home", "item": "https://txt-tool.com/"}, {"@type": "ListItem", "position": 2, "name": "Blog", "item": "https://txt-tool.com/blog/"}, {"@type": "ListItem", "position": 3, "name": "Markdown Cheat Sheet", "item": "https://txt-tool.com/blog/markdown-cheat-sheet.html"}]}</script> <link rel="alternate" hreflang="pt" href="https://txt-tool.com/pt/blog/markdown-cheat-sheet.html"> <link rel="alternate" hreflang="en" href="https://txt-tool.com/blog/markdown-cheat-sheet.html"> <script async src="https://www.googletagmanager.com/gtag/js?id=G-CZ7GQC3DKR"></script><script>window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}gtag("js",new Date());gtag("config","G-CZ7GQC3DKR",{"linker":{"domains":["conv-kit.com,go-calc.com,gen-kit.com,run-dev.com,seo-io.com,txt-tool.com,img-kit.com,the-pdf.com,dl-kit.com,nettool1.com"]}});</script></head> <body> <header class="site-header"> <div class="container header-inner"> <a href="/" class="logo"> <svg viewBox="0 0 28 28" width="28" height="28" fill="none" xmlns="http://www.w3.org/2000/svg"> <rect width="28" height="28" rx="6" fill="#06b6d4"/> <path d="M7 7h14M7 12h10M7 17h6" stroke="#fff" stroke-width="2" stroke-linecap="round"/> </svg> Txt<span class="logo-accent">Tool</span> </a> <button class="mobile-menu-btn" aria-label="Toggle menu" onclick="document.querySelector('.nav-links').classList.toggle('open')">☰</button> <nav class="nav-links" aria-label="Main navigation"> <a href="/" class="active">Home</a> <a href="/alltools/">Tools</a> <a href="/blog/">Blog</a> <a href="/about.html">About</a> </nav> <div class="header-actions"> <div class="lang-dropdown"> <button class="lang-btn" onclick="this.nextElementSibling.classList.toggle('show')" aria-label="Language"> <span>🇺🇸</span> EN <svg width="12" height="12" viewBox="0 0 12 12" fill="none"><path d="M3 5l3 3 3-3" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"/></svg> </button> <div class="lang-menu" id="langMenu"> <a href="/">🇺🇸 English</a> <a href="/es/">🇪🇸 Español</a> <a href="/fr/">🇫🇷 Français</a> <a href="/de/">🇩🇪 Deutsch</a> <a href="/ja/">🇯🇵 日本語</a> <a href="/pt/">🇧🇷 Português</a> <a href="/zh/">🇨🇳 中文</a> <a href="/ko/">🇰🇷 한국어</a> </div> </div> <button class="theme-toggle" id="themeToggle" onclick="toggleTheme()" title="Toggle theme"> <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"><circle cx="12" cy="12" r="5"/><path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"/></svg> </button> </div> </div> </header> <nav class="breadcrumb" aria-label="Breadcrumb"><div class="container"><a href="/">TxtTool</a><span class="sep">/</span><a href="/blog/">Blog</a><span class="sep">/</span><span>Markdown Cheat Sheet: Complete Reference Guide</span></div></nav> <main id="main-content"> <article class="container" style="max-width:800px;margin:2rem auto;padding:0 1rem"><h1>Folha de Referência Markdown: Guia de Referência Completo</h1> <p class="text-muted" style="margin-bottom:1.5rem"><time datetime="2026-03-31">31 de março de 2026</time> · 12 min de leitura</p> <p>Markdown se tornou a linguagem universal de formatação de texto na web. Seja escrevendo documentação no GitHub, postando no Reddit, conversando no Discord, organizando notas no Notion, ou criando conteúdo para inúmeras outras plataformas, Markdown está em todo lugar. Aprender esta sintaxe simples mas poderosa vai te tornar mais produtivo em todos os espaços de trabalho digitais que você usa.</p> <p>Este guia abrangente cobre tudo desde formatação básica até técnicas avançadas, completo com exemplos práticos e casos de uso do mundo real. Salve esta página como sua referência principal para tudo relacionado a Markdown.</p> <details open style="background:var(--bg-secondary);border:1px solid var(--border);border-radius:8px;padding:1.25rem;margin:1.5rem 0"> <summary style="cursor:pointer;font-weight:600;margin-bottom:0.75rem">📑 Índice</summary> <ul style="margin:0;padding-left:1.5rem"> <li><a href="#what-is-markdown">O que é Markdown e Por Que Usar?</a></li> <li><a href="#basic-formatting">Formatação Básica de Texto</a></li> <li><a href="#headings">Títulos e Estrutura de Documento</a></li> <li><a href="#lists">Listas: Ordenadas, Não Ordenadas e Aninhadas</a></li> <li><a href="#links-images">Links e Imagens</a></li> <li><a href="#code-blocks">Blocos de Código e Destaque de Sintaxe</a></li> <li><a href="#tables">Criando Tabelas</a></li> <li><a href="#blockquotes">Citações e Referências</a></li> <li><a href="#advanced-features">Recursos Avançados de Markdown</a></li> <li><a href="#flavors">Variações e Extensões de Markdown</a></li> <li><a href="#best-practices">Melhores Práticas e Erros Comuns</a></li> <li><a href="#faq">Perguntas Frequentes</a></li> </ul> </details> <h2 id="what-is-markdown">O que é Markdown e Por Que Usar?</h2> <p>Markdown é uma linguagem de marcação leve criada por John Gruber em 2004. Sua filosofia é simples: texto simples deve ser legível como está, mas também conversível para HTML e outros formatos. Ao contrário de editores de texto rico que escondem a formatação atrás de botões e menus, Markdown mantém tudo visível e portável.</p> <p>A beleza do Markdown está em sua simplicidade. Você pode escrevê-lo em qualquer editor de texto, versioná-lo com Git, e convertê-lo para HTML, PDF, ou dezenas de outros formatos. Tornou-se o padrão de fato para documentação técnica, arquivos README, posts de blog e escrita colaborativa.</p> <p><strong>Onde Markdown é usado:</strong></p> <ul> <li>GitHub, GitLab e Bitbucket para arquivos README e documentação</li> <li>Reddit, Discord e Slack para mensagens formatadas</li> <li>Notion, Obsidian e Roam Research para anotações</li> <li>Geradores de sites estáticos como Jekyll, Hugo e Gatsby</li> <li>Sistemas de gerenciamento de conteúdo e plataformas de blog</li> <li>Ferramentas de escrita técnica e plataformas de documentação</li> </ul> <div style="background:var(--bg-secondary);border:1px solid var(--border);border-radius:8px;padding:1.25rem;margin:1.5rem 0"><p style="margin:0"><strong>Dica profissional:</strong> Use nosso <a href="/tools/markdown-editor/">Editor Markdown</a> gratuito para praticar sintaxe em tempo real com visualização ao vivo. É a maneira mais rápida de aprender fazendo.</p></div> <h2 id="basic-formatting">Formatação Básica de Texto</h2> <p>A sintaxe de formatação básica do Markdown é intuitiva e fácil de lembrar. A maioria da formatação usa caracteres especiais que envolvem o texto que você quer estilizar.</p> <h3>Texto em Negrito</h3> <p>Crie texto em negrito envolvendo palavras com asteriscos duplos ou sublinhados duplos:</p> <pre><code>**Este texto está em negrito** __Isto também está em negrito__</code></pre> <p>Ambos produzem: <strong>Este texto está em negrito</strong></p> <h3>Texto em Itálico</h3> <p>Use asteriscos simples ou sublinhados simples para texto em itálico:</p> <pre><code>*Este texto está em itálico* _Isto também está em itálico_</code></pre> <p>Ambos produzem: <em>Este texto está em itálico</em></p> <h3>Negrito e Itálico Combinados</h3> <p>Combine ambos usando três asteriscos ou misturando asteriscos e sublinhados:</p> <pre><code>***Texto em negrito e itálico*** **_Também em negrito e itálico_**</code></pre> <p>Resultado: <strong><em>Texto em negrito e itálico</em></strong></p> <h3>Tachado</h3> <p>A maioria das variações de Markdown suporta tachado com til duplo:</p> <pre><code>~~Este texto está riscado~~</code></pre> <p>Resultado: <del>Este texto está riscado</del></p> <h3>Código Inline</h3> <p>Envolva texto em crases simples para formatá-lo como código inline:</p> <pre><code>Use a função `console.log()` para depurar.</code></pre> <p>Resultado: Use a função <code>console.log()</code> para depurar.</p> <table style="width:100%;border-collapse:collapse;margin:1.5rem 0"> <thead> <tr style="background:var(--bg-secondary)"> <th style="border:1px solid var(--border);padding:0.75rem;text-align:left">Sintaxe</th> <th style="border:1px solid var(--border);padding:0.75rem;text-align:left">Saída</th> <th style="border:1px solid var(--border);padding:0.75rem;text-align:left">Caso de Uso</th> </tr> </thead> <tbody> <tr> <td style="border:1px solid var(--border);padding:0.75rem"><code>**texto**</code></td> <td style="border:1px solid var(--border);padding:0.75rem"><strong>texto</strong></td> <td style="border:1px solid var(--border);padding:0.75rem">Ênfase, termos importantes</td> </tr> <tr> <td style="border:1px solid var(--border);padding:0.75rem"><code>*texto*</code></td> <td style="border:1px solid var(--border);padding:0.75rem"><em>texto</em></td> <td style="border:1px solid var(--border);padding:0.75rem">Ênfase sutil, títulos de livros</td> </tr> <tr> <td style="border:1px solid var(--border);padding:0.75rem"><code>~~texto~~</code></td> <td style="border:1px solid var(--border);padding:0.75rem"><del>texto</del></td> <td style="border:1px solid var(--border);padding:0.75rem">Conteúdo deletado, correções</td> </tr> <tr> <td style="border:1px solid var(--border);padding:0.75rem"><code>`texto`</code></td> <td style="border:1px solid var(--border);padding:0.75rem"><code>texto</code></td> <td style="border:1px solid var(--border);padding:0.75rem">Código, comandos, nomes de arquivo</td> </tr> </tbody> </table> <h2 id="headings">Títulos e Estrutura de Documento</h2> <p>Títulos criam hierarquia de documento e melhoram a legibilidade. Markdown suporta seis níveis de títulos, correspondendo às tags <code><h1></code> até <code><h6></code> do HTML.</p> <pre><code># Título 1 (Maior) ## Título 2 ### Título 3 #### Título 4 ##### Título 5 ###### Título 6 (Menor)</code></pre> <p>O número de símbolos de cerquilha determina o nível do título. Sempre inclua um espaço entre os símbolos de cerquilha e o texto do título.</p> <div style="background:var(--bg-secondary);border:1px solid var(--border);border-radius:8px;padding:1.25rem;margin:1.5rem 0"><p style="margin:0"><strong>Melhor prática:</strong> Use níveis de título hierarquicamente. Não pule de H1 para H4. Isso melhora a acessibilidade para leitores de tela e ajuda mecanismos de busca a entender a estrutura do seu conteúdo.</p></div> <h3>Sintaxe Alternativa de Título</h3> <p>Para H1 e H2, você também pode usar sintaxe de estilo sublinhado:</p> <pre><code>Título 1 ========= Título 2 ---------</code></pre> <p>No entanto, a sintaxe de símbolo de cerquilha é mais comum e suporta todos os seis níveis.</p> <h3>Melhores Práticas de Títulos</h3> <ul> <li>Use apenas um H1 por documento (tipicamente o título)</li> <li>Mantenha títulos concisos e descritivos</li> <li>Use capitalização de frase ou título consistentemente</li> <li>Não termine títulos com pontuação</li> <li>Adicione linhas em branco antes e depois dos títulos para legibilidade</li> </ul> <h2 id="lists">Listas: Ordenadas, Não Ordenadas e Aninhadas</h2> <p>Listas são fundamentais para organizar informações. Markdown suporta listas não ordenadas (com marcadores), listas ordenadas (numeradas) e combinações aninhadas de ambas.</p> <h3>Listas Não Ordenadas</h3> <p>Crie listas com marcadores usando asteriscos, hífens ou sinais de mais. Todos os três produzem saída idêntica:</p> <pre><code>* Primeiro item * Segundo item * Terceiro item - Primeiro item - Segundo item - Terceiro item + Primeiro item + Segundo item + Terceiro item</code></pre> <p>Escolha um estilo e mantenha-o em todo o seu documento para consistência.</p> <h3>Listas Ordenadas</h3> <p>Numere seus itens de lista com pontos. Os números reais não importam—Markdown os renumerará automaticamente:</p> <pre><code>1. Primeiro item 2. Segundo item 3. Terceiro item 1. Primeiro item 1. Segundo item 1. Terceiro item</code></pre> <p>Ambos produzem a mesma lista numerada. Usar todos 1s facilita reordenar itens sem renumerar.</p> <h3>Listas Aninhadas</h3> <p>Indente itens aninhados com 2 ou 4 espaços (seja consistente):</p> <pre><code>1. Primeiro item - Marcador aninhado - Outro marcador aninhado 2. Segundo item 1. Número aninhado 2. Outro número aninhado</code></pre> <h3>Listas de Tarefas</h3> <p>Muitas variações de Markdown suportam listas de tarefas com caixas de seleção:</p> <pre><code>- [x] Tarefa concluída - [ ] Tarefa incompleta - [ ] Outra tarefa incompleta</code></pre> <p>Isso é particularmente útil em issues do GitHub e ferramentas de gerenciamento de projetos.</p> <div style="background:var(--bg-secondary);border:1px solid var(--border);border-radius:8px;padding:1.25rem;margin:1.5rem 0"><p style="margin:0"><strong>Dica rápida:</strong> Ao escrever itens de lista com múltiplos parágrafos, indente parágrafos subsequentes para alinhar com a primeira linha de texto, não com o marcador.</p></div> <h2 id="links-images">Links e Imagens</h2> <p>Markdown facilita adicionar hiperlinks e imagens sem poluir seu texto com tags HTML.</p> <h3>Links Básicos</h3> <p>A sintaxe para links é direta: colchetes para o texto do link, seguido por parênteses para a URL:</p> <pre><code>[Visite nosso Editor Markdown](/tools/markdown-editor/)</code></pre> <p>Resultado: <a href="/tools/markdown-editor/">Visite nosso Editor Markdown</a></p> <h3>Links com Títulos</h3> <p>Adicione um atributo de título (mostrado ao passar o mouse) incluindo-o entre aspas após a URL:</p> <pre><code>[GitHub](https://github.com "Visite o GitHub")</code></pre> <h3>Links Estilo Referência</h3> <p>Para documentos com muitos links repetidos, use sintaxe estilo referência para manter seu texto limpo:</p> <pre><code>Confira [Google][1] e [GitHub][2] para mais informações. [1]: https://google.com "Google" [2]: https://github.com "GitHub"</code></pre> <p>As definições de referência podem aparecer em qualquer lugar no documento e não serão visíveis na saída.</p> <h3>Links Automáticos</h3> <p>Envolva URLs ou endereços de email em colchetes angulares para torná-los clicáveis:</p> <pre><code><https://example.com> <email@example.com></code></pre> <p>Muitos processadores Markdown também criam links automáticos de URLs sem colchetes angulares.</p> <h3>Imagens</h3> <p>A sintaxe de imagem é idêntica a links, mas com um prefixo de ponto de exclamação:</p> <pre><code>![Texto alternativo descrevendo a imagem](image-url.png) ![Texto alternativo](image-url.png "Título opcional")</code></pre> <p>O texto alternativo é crucial para acessibilidade e SEO. Sempre forneça texto alternativo descritivo que explique o que a imagem mostra.</p> <h3>Melhores Práticas de Imagens</h3> <ul> <li>Escreva texto alternativo descritivo para acessibilidade</li> <li>Use caminhos relativos para imagens no mesmo repositório</li> <li>Otimize tamanhos de arquivo de imagem para carregamento mais rápido</li> <li>Considere usar sintaxe estilo referência para imagens repetidas</li> <li>Teste se as imagens são exibidas corretamente na sua plataforma alvo</li> </ul> <h2 id="code-blocks">Blocos de Código e Destaque de Sintaxe</h2> <p>Blocos de código são essenciais para documentação técnica. Markdown fornece múltiplas maneiras de formatar código, desde trechos inline até blocos de múltiplas linhas com destaque de sintaxe.</p> <h3>Código Inline</h3> <p>Como mencionado anteriormente, envolva código inline em crases simples:</p> <pre><code>Use o comando `git commit` para salvar alterações.</code></pre> <h3>Blocos de Código Cercados</h3> <p>Para código de múltiplas linhas, use crases triplas (ou tils triplos) antes e depois do código:</p> <pre><code>``` function greet(name) { return `Hello, ${name}!`; } ```</code></pre> <h3>Destaque de Sintaxe</h3> <p>Especifique a linguagem de programação após as crases de abertura para destaque de sintaxe:</p> <pre><code>```javascript function greet(name) { return `Hello, ${name}!`; } ``` ```python def greet(name): return f"Hello, {name}!" ``` ```css .button { background-color: #06b6d4; border-radius: 8px; } ```</code></pre> <p>A maioria dos processadores Markdown suporta dezenas de linguagens incluindo JavaScript, Python, Java, C++, Ruby, Go, Rust, SQL, HTML, CSS e muitas mais.</p> <h3>Blocos de Código Indentados</h3> <p>Uma sintaxe mais antiga usa indentação de 4 espaços para criar blocos de código:</p> <pre><code> function example() { return true; }</code></pre> <p>No entanto, blocos de código cercados são preferidos porque suportam destaque de sintaxe e são mais fáceis de ler em texto simples.</p> <div style="background:var(--bg-secondary);border:1px solid var(--border);border-radius:8px;padding:1.25rem;margin:1.5rem 0"><p style="margin:0"><strong>Dica profissional:</strong> Use nosso <a href="/tools/html-beautifier/">Embelezador HTML</a> para formatar código antes de colá-lo em documentos Markdown. Código limpo e bem formatado é mais fácil de ler e manter.</p></div> <h2 id="tables">Criando Tabelas</h2> <p>Tabelas organizam dados em linhas e colunas. Embora tabelas Markdown não sejam tão flexíveis quanto tabelas HTML, são perfeitas para apresentação de dados simples.</p> <h3>Sintaxe Básica de Tabela</h3> <p>Crie tabelas usando barras verticais e hífens:</p> <pre><code>| Cabeçalho 1 | Cabeçalho 2 | Cabeçalho 3 | |-------------|-------------|-------------| | Célula 1 | Célula 2 | Célula 3 | | Célula 4 | Célula 5 | Célula 6 |</code></pre> <p>As barras verticais não precisam estar perfeitamente alinhadas—processadores Markdown as formatarão corretamente. No entanto, barras alinhadas tornam tabelas mais fáceis de ler em texto simples.</p> <h3>Alinhamento de Colunas</h3> <p>Controle o alinhamento de texto usando dois pontos na linha separadora:</p> <pre><code>| Alinhado à esquerda | Centralizado | Alinhado à direita | |:--------------------|:------------:|-------------------:| | Texto | Texto | Texto | | Mais texto | Mais texto | Mais texto |</code></pre> <ul> <li><code>:---</code> alinha à esquerda (padrão)</li> <li><code>:---:</code> centraliza texto</li> <li><code>---:</code> alinha à direita</li> </ul> <h3>Exemplo Prático de Tabela</h3> <table style="width:100%;border-collapse:collapse;margin:1.5rem 0"> <thead> <tr style="background:var(--bg-secondary)"> <th style="border:1px solid var(--border);padding:0.75rem;text-align:left">Variação Markdown</th> <th style="border:1px solid var(--border);padding:0.75rem;text-align:left">Tabelas</th> <th style="border:1px solid var(--border);padding:0.75rem;text-align:left">Listas de Tarefas</th> <th style="border:1px solid var(--border);padding:0.75rem;text-align:left">Notas de Rodapé</th> </tr> </thead> <tbody> <tr> <td style="border:1px solid var(--border);padding:0.75rem">CommonMark</td> <td style="border:1px solid var(--border);padding:0.75rem">❌ Não</td> <td style="border:1px solid var(--border);padding:0.75rem">❌ Não</td> <td style="border:1px solid var(--border);padding:0.75rem"></article> </main> <footer class="site-footer"> <div class="container"> <div class="footer-grid"> <div class="footer-col"><h4>Format</h4><a href="/tools/sort-lines/">Sort Lines</a><a href="/tools/remove-duplicates/">Remove Duplicates</a></div> <div class="footer-col"><h4>Encode</h4><a href="/tools/unicode-converter/">Unicode Converter</a></div> <div class="footer-col"><h4>Count</h4><a href="/tools/word-counter/">Word Counter</a><a href="/tools/character-counter/">Character Counter</a><a href="/tools/line-counter/">Line Counter</a><a href="/tools/text-statistics/">Text Statistics</a></div> <div class="footer-col"><h4>Convert</h4><a href="/tools/markdown-to-html/">Markdown To Html</a><a href="/tools/html-to-text/">Html To Text</a><a href="/tools/csv-to-json/">Csv To Json</a><a href="/tools/json-to-csv/">Json To Csv</a></div> <div class="footer-col"><h4>Company</h4><a href="/about.html">About</a><a href="/blog/">Blog</a><a href="/contact.html">Contact</a><a href="/sitemap.xml">Sitemap</a></div> </div> <div class="footer-bottom"> <span>© 2026 TxtTool. All processing happens in your browser.</span> <div class="footer-legal"><a href="/privacy.html">Privacy</a><a href="/terms.html">Terms</a></div> </div> </div> <div class="matrix-links" style="text-align:center;padding:10px 0;border-top:1px solid rgba(255,255,255,0.05)"><span style="color:#666;font-size:0.75em">More Tools: </span><a href="https://run-dev.com/" rel="nofollow noopener" style="color:#68a;text-decoration:none;font-size:0.8em;margin-right:12px">run-dev</a><a href="https://img-kit.com/" rel="nofollow noopener" style="color:#68a;text-decoration:none;font-size:0.8em;margin-right:12px">img-kit</a><a href="https://the-pdf.com/" rel="nofollow noopener" style="color:#68a;text-decoration:none;font-size:0.8em;margin-right:12px">the-pdf</a><a href="https://nettool1.com/" rel="nofollow noopener" style="color:#68a;text-decoration:none;font-size:0.8em;margin-right:12px">nettool1</a></div></footer> </body> </html>