O cheatsheet de markdown mais completo online

O cheatsheet de markdown mais completo online. Cada elemento de sintaxe com exemplos, saída renderizada, compatibilidade de plataforma, erros comuns e dicas de especialistas. Marque-o.

Benjamin McBrayer // Publicado: 21 de abril de 202618 min de leitura

Também em

English Deutsch Español Français Italiano

Markdown é uma maneira simples de formatar texto usando símbolos como hashtags, asteriscos e colchetes. É útil para escritores, blogueiros, desenvolvedores, estudantes e qualquer pessoa que crie conteúdo online, porque torna a formatação rápida, limpa e fácil de reutilizar em diferentes plataformas. Esta folha de dicas do Markdown mostrará as regras mais comuns para que você possa escrever e publicar no Markdown a partir de agora.

O que é Markdown?

Markdown é uma linguagem de marcação leve que permite usar símbolos de texto simples para formatar documentos. Quando você digita **bold** você fica em negrito. Quando você digita # Heading ele se torna um título. Quando você usa Markdown, ele converte para HTML. Funciona em praticamente todas as plataformas e se tornou a linguagem padrão para formatação em milhares de ferramentas, plataformas e sites, incluindo GitHub, Reddit, Discord, Notion, Slack e Obsidian.

Por que o Markdown é importante

John Gruber criou o Markdown em 2004 com o objetivo de permitir que as pessoas escrevessem e formatassem documentos usando texto simples, sem olhar para uma confusão de tags. Hoje, Markdown se tornou uma linguagem usada por praticamente todos os desenvolvedores e construtores, bem como por redatores de conteúdo e outros.

Os benefícios do Markdown

Markdown é tão popular porque resolve muitos problemas que existiam nos formatos anteriores.

Markdown funciona em qualquer lugar e sempre funcionará: Você pode abrir um arquivo .md em qualquer editor de texto e em qualquer sistema operacional, e poderá abri-lo daqui a 50 anos.
Você pode ler Markdown sem renderizá-lo: Ao contrário de RTF ou HTML, Markdown é um formato legível em sua forma bruta, não apenas após renderizá-lo.
Markdown é rápido de trabalhar: Escritores experientes podem formatar o texto à medida que o digitam e trabalhar com mais rapidez.
Markdown é universal: Como mencionado antes, muitas plataformas usam Markdown nativamente.

Hoje em dia, é importante saber Markdown para qualquer pessoa que esteja construindo algo com ferramentas de IA, porque os LLMs geram Markdown por padrão.

Sintaxe Básica de Markdown

Esses elementos vêm da especificação original de 2004 de John Gruber. Cada analisador de markdown os suporta, com pequenas diferenças de implementação mencionadas abaixo.

Tabela de referência rápida

Elemento	Sintaxe de redução
Título de redução	`#H1` `## H2` `### H3`
Markdown Negrito	`negrito` ou `__bold__`
Markdown Itálico	`itálico` ou `_itálico_`
Markdown Negrito + Itálico	`*negrito itálico*`
Markdown Blockquote	`> texto citado`
Lista ordenada de redução	`1. Artigo`
Lista não ordenada de Markdown	`- Item` ou `* Item` ou `+ Item`
Código embutido Markdown	`código`
Bloco de código Markdown	Recue 4 espaços ou use blocos cercados
Regra horizontal de redução	`---` ou `***` ou `___`
Link de redução	`[texto](https://example.com)`
Imagem de redução	`![texto alternativo](imagem.jpg)`
Quebra de linha de redução	Terminar uma linha com dois espaços à direita
Personagem de escape Markdown	`\asterisco literal\`

Títulos de redução

Use sinais de 1 a 6 libras (#) seguidos de um espaço. O número de sinais corresponde ao nível do título HTML.

# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

Sintaxe alternativa (estilo Setext) funciona apenas para H1 e H2:

Heading 1
=========

Heading 2
---------

Práticas recomendadas:

Sempre coloque um espaço entre # e o texto do título. #Heading funciona em alguns analisadores, mas quebra em outros.
Utilize apenas um H1 por documento (geralmente o título da página).
Não pule os níveis de título. Vá H1 → H2 → H3, não H1 → H3.
Adicione linhas em branco antes e depois dos títulos para máxima compatibilidade.

Markdown Negrito, Itálico e Ênfase

**This is bold** and __this is also bold__
*This is italic* and _this is also italic_
***Bold and italic*** combined

Renderiza como:

Isso é ousado e isso também é ousado Isso está em itálico e isso também está em itálico Negrito e itálico combinados

Entendi: Alguns analisadores não lidam com sublinhados no meio de uma palavra. Para máxima compatibilidade, use asteriscos para ênfase no meio da palavra: un**believ**able, não un__believ__able.

Markdown Blockquotes

Comece qualquer linha com > para criar uma markdown blockquote.

> This is a single-line blockquote.

> This is a blockquote
> that spans multiple lines.

> Blockquotes can be nested.
>
> > Like this.
>
> And they can contain **other markdown** elements.

As citações em bloco Markdown funcionam bem para enfatizar citações, textos explicativos e formatação de estilo de resposta em e-mails.

Listas de descontos

Listas não ordenadas aceitam -, * ou + alternadamente. Escolha um estilo e mantenha-o para obter consistência.

- First item
- Second item
- Third item
  - Nested item (indent two or four spaces)
  - Another nested item
- Fourth item

Listas ordenadas usam números seguidos de um ponto:

1. First item
2. Second item
3. Third item

Truque útil: Os números não precisam estar corretos. Markdown renumera automaticamente:

1. First
1. Second
1. Third

… é renderizado de forma idêntica a 1, 2, 3. Isso significa que você pode reordenar itens sem renumerar.

Aninhando listas de descontos ordenadas e não ordenadas:

1. First step
2. Second step
   - Sub-bullet
   - Another sub-bullet
3. Third step
   1. Sub-step
   2. Another sub-step

Liste itens com vários parágrafos: Recue a continuação com o mesmo número de espaços (geralmente 4 ou uma tabulação):

1. First item

    This paragraph belongs to the first item.
    Notice the blank line above and the indent.

2. Second item

Links de redução

Links inline são o estilo mais comum:

[Visit Google](https://www.google.com)
[With hover title](https://www.google.com "Google's homepage")

Links de redução de estilo de referência são úteis quando o mesmo URL aparece várias vezes ou quando você deseja manter a prosa limpa:

I love [Obsidian][1] and [VS Code][vscode] for markdown.

[1]: https://obsidian.md
[vscode]: https://code.visualstudio.com

URLs automáticos. Coloque um URL simples entre colchetes angulares:

<https://example.com>
<hello@example.com>

Links relativos. Link para arquivos no mesmo repositório ou pasta:

[Read the license](./LICENSE.md)
[Parent directory file](../README.md)

Links de âncora Markdown. Vá para um título na mesma página. A maioria dos analisadores gera IDs automaticamente a partir do texto do título (minúsculas, espaços em hífens):

Jump to [the installation section](#installation).

## Installation

Imagens de redução

A sintaxe da imagem Markdown é a sintaxe do link com um ponto de exclamação à esquerda:

![Descriptive alt text](/path/to/image.jpg)
![Alt text](/path/to/image.jpg "Optional hover title")

Imagens de redução de estilo de referência funcionam da mesma maneira que links de referência:

![Company logo][logo]

[logo]: /images/logo.png "Our logo"

Transformando uma imagem de markdown em um link:

[![Alt text](image.jpg)](https://example.com)

Dimensionando imagens. O markdown puro não tem sintaxe para isso. Use HTML embutido como substituto:

<img src="image.jpg" alt="Alt text" width="400">

Nota de acessibilidade: Sempre escreva um texto alternativo significativo. Os leitores de tela dependem disso e os motores de busca o utilizam para compreender o conteúdo da imagem. ![](logo.png) é ruim; ![Logotipo da empresa, círculo azul com um M branco](logo.png) é bom.

Código de redução

Código in-line Markdown agrupado em crases únicos:

Install with `npm install markdown-it`.

Blocos de código Markdown. Recue cada linha com quatro espaços (ou uma tabulação):

    function hello() {
      console.log("Hello, world!");
    }

Na prática, quase todo mundo usa blocos de código protegidos (abordados na seção de sintaxe estendida abaixo) porque eles suportam realce de sintaxe.

Escapando crases dentro do código embutido. Use mais crases do lado de fora:

To show a backtick, use `` `backtick` `` like this.

Regras horizontais de redução

Três ou mais hífens, asteriscos ou sublinhados em sua própria linha:

---
***
___

Todos os três são renderizados de forma idêntica. Coloque linhas em branco antes e depois para compatibilidade.

Quebras de linha de redução

Este é um dos recursos mais confusos do markdown. Existem três comportamentos diferentes:

Quebra de parágrafo. Deixe uma linha em branco entre o texto:

This is paragraph one.

This is paragraph two.

Quebra de linha rígida (mesmo parágrafo). Finalize uma linha com dois espaços à direita:

This line ends with two spaces.␣␣
This line is a break within the same paragraph.

HTML fallback. Use <br> quando os espaços finais parecerem muito frágeis:

This line has an HTML break.<br>
This is the next line.

Por que os espaços finais são controversos: Eles são invisíveis. A maioria dos editores os retira ao salvar. GitHub Flavored Markdown (GFM) resolve isso tratando qualquer nova linha como uma quebra de linha dentro de um parágrafo, mas o CommonMark padrão requer espaços à direita.

Personagens de escape Markdown

Para exibir um caractere que o markdown normalmente interpretaria como formatação, coloque uma barra invertida antes dele:

\*This shows literal asterisks\*
\# This shows a literal hash sign
\[not a link\]

Caracteres escapáveis: \ ` * _ {} [] () # + - . ! |

Sintaxe de Markdown Estendida

Esses elementos não estão na especificação original de Gruber, mas os processadores de markdown mais usados os suportam, incluindo GitHub, GitLab, Reddit, Stack Overflow, Obsidian, Notion e Discord. A compatibilidade varia, portanto verifique a matriz abaixo antes de confiar em qualquer um deles.

Tabela de referência rápida

Elemento	Sintaxe de redução
Tabela de redução	`\| Cabeçalho \| Cabeçalho \|` + `\| --- \| --- \|`
Bloco de código protegido Markdown	```linguagem ...```
Destaque de sintaxe Markdown	Nome do idioma após abertura da cerca
Nota de rodapé de redução	`Aqui está uma nota.[^1]` ... `[^1]: Texto da nota.`
ID do título de redução	`### Meu título {#custom-id}`
Lista de definições de Markdown	`term` nova linha `: definição`
Markdown Tachado	`~~texto excluído~~`
Lista de tarefas de redução	`- [x] Concluído` `- [ ] Todo`
Código abreviado do emoji Markdown	`:alegria:` `:foguete:`
Destaque de redução	`==destacado==`
Subscrito de redução	`H~2~O`
Markdown sobrescrito	`E = mc^2^`
URL automático de redução	`<https://exemplo.com>`
Alertas de redução do GitHub	`> [!NOTE]` `> [!WARNING]` `> [!TIP]`

Tabelas de redução

Use barras verticais (|) para colunas e uma linha de hífens para o separador de cabeçalho.

| Name     | Role       | Location      |
| -------- | ---------- | ------------- |
| Alice    | Developer  | Berlin        |
| Bob      | Designer   | Montreal      |
| Carol    | Writer     | Sydney        |

Alinhamento da coluna. Adicione dois pontos à linha separadora:

| Left-aligned | Centered     | Right-aligned |
| :----------- | :----------: | ------------: |
| apples       | bananas      |          $100 |
| cherries     | dates        |           $12 |

Dicas que a maioria dos guias não percebe:

Você não precisa alinhar os tubos da sua fonte. O renderizador lida com o espaçamento.
Os tubos externos são opcionais, mas adicioná-los ajuda na legibilidade e nos plug-ins do editor.
Você pode usar markdown básico dentro das células (**negrito**, *itálico*, `código`, links).
Você não pode usar elementos de bloco (títulos, aspas, listas) dentro das células.
Para conteúdo multilinha dentro de uma célula, use <br> em vez de uma quebra de linha.
Para exibir uma barra vertical literal dentro de uma célula, use a entidade HTML |.

Blocos de código protegidos Markdown

Três crases (ou tils) abrem e fecham um bloco. Adicione um identificador de idioma após a cerca de abertura para realce de sintaxe:

```píton
def cumprimentar(nome):
    return f"Olá, {nome}!"

imprimir(saudação("mundo"))```

Identificadores de linguagem comuns: python, javascript, typescript, bash, shell, sql, json, yaml, html, css, rust, go, java, c, cpp, csharp, php, ruby, swift, kotlin, dart, r, escala, diff.

Mostrando alterações de código com diff:

```diferença
- const old = "remover isto";
+ const new = "adicionar isto";```

Escapando de crases triplos. Enrole o bloco em quatro crases:

````
Este bloco contém```triple backticks```dentro.````

Notas de rodapé de redução

As notas de rodapé Markdown são perfeitas para citações, apartes e notas explicativas sem sobrecarregar sua prosa.

Here is a statement that needs a source.[^1]

Here is another claim.[^detailed-note]

[^1]: This is a short footnote.
[^detailed-note]: Named footnotes still render as numbers, but they're
    easier to track in the source. They can span multiple lines if you
    indent the continuation.

IDs de cabeçalho de redução

Alguns analisadores permitem atribuir IDs personalizados a títulos para uma ligação âncora precisa:

### My Great Heading {#custom-heading-id}

Jump to [my heading](#custom-heading-id).

GitHub e muitos outros geram IDs automaticamente a partir do texto do título, então você geralmente não precisa disso.

Listas de definição de Markdown

Markdown
: A lightweight markup language for formatting plain text.

HTML
: The standard markup language for web pages.

CSS
: The language used to style HTML documents.

O suporte é irregular. Funciona em Pandoc, PHP Markdown Extra e alguns outros, mas não no GFM padrão.

Markdown Tachado

Quebrar o texto em dois tis para riscá-lo:

~~This text is struck through.~~

Renderiza como: ~~Este texto está riscado.~~

Funciona em GFM, Reddit, Discord, Slack e nos processadores mais usados. Não no CommonMark padrão.

Listas de tarefas de redução

Caixas de seleção interativas, comumente usadas em problemas do GitHub, pull requests e quadros de projetos:

- [x] Write the first draft
- [x] Edit for clarity
- [ ] Publish the article
- [ ] Promote on social media
  - [ ] Twitter
  - [ ] LinkedIn
  - [ ] Hacker News

No GitHub, elas são renderizadas como caixas de seleção clicáveis que você pode alternar diretamente na IU.

Emoji de redução

A maioria das plataformas suporta códigos de acesso emoji:

Ship it :rocket: and celebrate :tada::champagne:

Você também pode colar caracteres emoji reais diretamente. Eles são renderizados bem em qualquer arquivo markdown, pois são apenas Unicode. 🚀🎉

Markdown Destaque, Subscrito, Sobrescrito

I need to ==highlight== this important idea.
Water is H~2~O.
Einstein's famous equation: E = mc^2^.

O suporte é limitado. Funciona em Obsidian, MultiMarkdown e alguns analisadores estendidos, mas não em GFM.

Markdown Link automático de URL

Coloque um URL entre colchetes angulares para criar um link automático:

<https://example.com>
<contact@example.com>

No GitHub Flavored Markdown, qualquer URL simples é convertido automaticamente. Você nem precisa dos colchetes.

Matriz de compatibilidade de plataforma

Use esta tabela para verificar quais elementos de sintaxe funcionam nas plataformas que você usa. "Sim" significa suporte total, "Não" significa sem suporte e "Parcial" significa que o recurso funciona com limitações ou usa uma sintaxe não padrão.

Recurso	GFM	GitLab	Reddit	Discórdia	Folga	Noção	Obsidiana	Estouro de pilha
Títulos	Sim	Sim	Sim	Não	Não	Sim	Sim	Sim
Negrito/Itálico	Sim	Sim	Sim	Sim	Parcial*	Sim	Sim	Sim
Tachado	Sim	Sim	Sim	Sim	Sim	Sim	Sim	Sim
Citação em bloco	Sim	Sim	Sim	Sim	Sim	Sim	Sim	Sim
Listas	Sim	Sim	Sim	Sim	Sim	Sim	Sim	Sim
Código embutido	Sim	Sim	Sim	Sim	Sim	Sim	Sim	Sim
Código Cercado	Sim	Sim	Sim	Sim	Sim	Sim	Sim	Sim
Destaque de sintaxe	Sim	Sim	Parcial	Parcial	Não	Sim	Sim	Sim
Ligações	Sim	Sim	Sim	Sim	Parcial**	Sim	Sim	Sim
Imagens	Sim	Sim	Parcial	Parcial	Parcial	Sim	Sim	Sim
Tabelas	Sim	Sim	Sim	Não	Não	Sim	Sim	Sim
Listas de tarefas	Sim	Sim	Não	Não	Não	Sim	Sim	Não
Notas de rodapé	Sim	Sim	Não	Não	Não	Não	Sim	Não
Códigos de acesso de emojis	Sim	Sim	Não	Sim	Sim	Não	Parcial	Não
Matemática (LaTeX)	Sim	Sim	Não	Não	Não	Sim	Sim	Sim
Diagramas de sereia	Sim	Sim	Não	Não	Não	Não	Sim	Não
Sublinhado	Não	Não	Não	Sim	Não	Sim	Parcial	Não
Texto de spoiler	Não	Não	Sim	Sim	Não	Não	Não	Não

* O Slack usa asteriscos simples para negrito (não duplo) e sublinhados simples para itálico. ** O Slack usa a sintaxe <url|text> em vez de links markdown padrão.

Markdown com sabor do GitHub

GitHub Flavored Markdown (GFM) é o dialeto de markdown mais influente. Como o GitHub é o local padrão para projetos de código aberto, as convenções GFM se tornaram o padrão de fato.

O GFM adiciona o seguinte além da redução padrão:

Alertas GitHub

Uma sintaxe de blockquote especial para textos explicativos. Cinco tipos são suportados:

> [!NOTE]
> Useful information that users should know.

> [!TIP]
> Helpful advice for doing things better.

> [!IMPORTANT]
> Key information users need to know.

> [!WARNING]
> Urgent info needing immediate attention.

> [!CAUTION]
> Advises about risks or negative outcomes.

Cada um é renderizado com uma cor e um ícone distintos no GitHub.

Referências vinculadas automaticamente ao Markdown

Dentro dos repositórios do GitHub, certos padrões tornam-se links automaticamente:

#123 → links para emitir ou receber solicitação #123
@username → menciona um usuário
org/repo#123 → links para um problema em outro repositório
a1b2c3d → links para um hash de commit

Diagramas de sereia Markdown

Blocos de código protegidos com sereia como linguagem renderizada como fluxogramas, diagramas de sequência e muito mais:

```sereia
gráfico LR
    A[Iniciar] --> B{Decisão}
    B -->|Sim| C[Faça a coisa]
    B -->|Não| D[Ignore]```

Expressões matemáticas Markdown

GFM suporta matemática LaTeX de duas formas:

Inline math: $E = mc^2$

Block math:

$$
\frac{n!}{k!(n-k)!} = \binom{n}{k}
$$

Markdown específico da plataforma

Marcação de discórdia

Discord usa sua própria variante de redução. Principais diferenças do padrão:

__underline__ (sublinhado duplo) produz sublinhado, não negrito
**negrito** ainda funciona
*italic* e _italic_ ambos funcionam
||spoiler|| oculta o texto até ser clicado
# Heading funciona, mas apenas H1, H2 e H3 são suportados
Blocos de código e código embutido funcionam normalmente
Sem tabelas, sem imagens via sintaxe de marcação

Markdown do Slack (mrkdwn)

O sabor de redução do Slack, confusamente chamado de “mrkdwn”, diverge significativamente:

*bold* usa asteriscos simples (não duplos)
_italic_ usa sublinhados únicos
~tachado~ usa tis únicos
`código` funciona normalmente
> quote funciona normalmente
Os links usam a sintaxe <https://example.com|link text>
Sem títulos, sem tabelas, sem listas de tarefas

Se você colar o markdown padrão no Slack, ele não será formatado corretamente. Converta primeiro.

Remarcação Reddit

Reddit oferece suporte à sintaxe mais padrão e estendida com algumas peculiaridades:

>!spoiler!< para texto de spoiler
^sobrescrito com um acento circunflexo (não é necessário acento circunflexo de fechamento para palavras únicas)
Suporta tabelas, tachados e blocos de código
Não oferece suporte a listas de tarefas, notas de rodapé ou IDs de cabeçalho personalizados

Markdown de noção

O Notion oferece suporte à entrada de markdown, mas a converte em seu sistema de blocos. Você pode digitar markdown para criar blocos rapidamente:

A redução padrão funciona durante a entrada
O Notion adiciona seus próprios recursos (bancos de dados, alternâncias, textos explicativos) que não são descontos padrão
Colar conteúdo de remarcação geralmente é importado de forma limpa

Markdown de Obsidiana

Obsidian é um aplicativo de anotações que usa markdown, com diversas extensões:

[[Links estilo Wiki]] para links internos entre notas
[[Note#heading]] para vincular a um título específico em outra nota
![[Note]] para incorporar o conteúdo de outra nota
> [!note] Título da frase de destaque para chamadas Obsidian (semelhantes aos alertas do GitHub)
Suporte completo para matemática LaTeX
Suporte completo para sereia

Erros comuns de redução de preço

Mesmo escritores experientes cometem esses erros de redução. Veja o que evitar e como.

1. Faltam linhas em branco ao redor dos elementos do bloco de marcação

Listas, títulos, blocos de código e aspas geralmente precisam de uma linha em branco antes e depois. Sem ele, alguns analisadores os mesclam no parágrafo circundante.

Errado:```markdown Here is a paragraph.

Heading

More text.


**Certo:**```markdown
Here is a paragraph.

## Heading

More text.

2. Recuo inconsistente da lista de descontos

Listas aninhadas precisam de recuo consistente. Misturar recuos de dois e quatro espaços, ou misturar tabulações e espaços, produz resultados imprevisíveis. Escolha um e fique com ele.

3. Esquecendo espaços finais para quebras de linha de marcação

Se você quiser uma quebra de linha dentro de um parágrafo, mas o texto estiver junto, provavelmente você esqueceu os dois espaços finais. Esta é a pergunta de redução mais comum no Stack Overflow.

4. Caminhos de imagem de marcação relativa quebrados após a implantação

![logo](images/logo.png) funciona em seu editor, mas quebra quando implantado em um subdiretório. Use caminhos absolutos do site (/images/logo.png) ou URLs totalmente qualificados para portabilidade.

5. Usando aspas inteligentes no estilo Word em blocos de código de remarcação

Quando você cola o código de um documento que contém aspas curvas (" em vez de "), o código não funcionará quando copiado. Sempre cole o código como texto simples em arquivos markdown.

6. Misturando HTML e markdown dentro do mesmo bloco

Markdown dentro de tags HTML em nível de bloco geralmente não é renderizado. Isso falha:

<div>
**This bold won't render.**
</div>

Corrija-o separando-os com linhas em branco ou usando apenas HTML embutido:

<div>

**This bold will render.**

</div>

7. Ignorando níveis de cabeçalho de redução

Ir do H1 diretamente para o H3 diminui o nível de acessibilidade e prejudica o SEO. Use níveis de título sequencialmente.

8. Usando sublinhados dentro de palavras em markdown

un_believ_able produz itálico em alguns analisadores e sublinhados literais em outros. Use asteriscos para ênfase no meio da palavra: un*believ*able.

Perguntas frequentes sobre descontos

Para que serve o markdown?

Markdown é usado para documentação (READMEs, documentos de API, wikis), postagens de blogs, redação técnica, anotações, mensagens de bate-papo em plataformas como Discord e Slack, sites estáticos, e-books e em qualquer lugar que a formatação de texto simples seja útil. A maioria dos grandes modelos de linguagem gera respostas em descontos por padrão.

O desconto é o mesmo em todas as plataformas?

Não. A sintaxe básica (títulos, ênfase, listas, links, código, aspas) funciona em quase todos os lugares, mas recursos estendidos como tabelas, notas de rodapé, listas de tarefas e matemática variam significativamente entre plataformas. Consulte a matriz de compatibilidade acima para obter mais informações.

Qual extensão de arquivo o markdown usa?

.md é o mais comum. Você também pode ver .markdown, .mdown, .mkd ou .mkdn. Eles são todos do mesmo formato. O tipo MIME é text/markdown, registrado na RFC 7763.

Posso usar HTML dentro do markdown?

Sim. Quase todo processador de markdown passa HTML bruto para a saída. É assim que as pessoas adicionam recursos que o markdown não suporta nativamente, como tags <kbd> para teclas do teclado, <details> para seções recolhíveis, <iframe> para incorporações e muito mais.

Como faço para converter markdown em PDF, Word ou HTML?

Para HTML: Todo processador de markdown faz isso nativamente. Pandoc, markdown-it emarked são bibliotecas populares.

Para PDF: Use Pandoc (pandoc input.md -o output.pdf), o recurso de exportação do Typora ou VS Code com a extensão Markdown PDF.

Para Word (.docx): Pandoc lida com isso de forma limpa com pandoc input.md -o output.docx.

O markdown suporta equações matemáticas?

Não na especificação original, mas muitos processadores (GitHub, GitLab, Obsidian, MkDocs, Jupyter, Notion) suportam matemática LaTeX. Use $...$ para matemática embutida e $$...$$ para equações de bloco.

Qual a diferença entre o markdown e o HTML?

HTML usa tags (<p>, <strong>, <a>) que são detalhadas, mas precisas. Markdown usa símbolos de pontuação que são rápidos de digitar e permanecem legíveis em formato de texto simples. Cada arquivo markdown é finalmente convertido em HTML para exibição. Markdown é um superconjunto de HTML. Você sempre pode colocar HTML em um arquivo markdown quando precisar de algo que o markdown não pode expressar.

O que é CommonMark?

CommonMark é uma especificação padronizada para remarcação, publicada em 2014 para resolver ambiguidades nas especificações originais de Gruber. A maioria dos processadores implementa CommonMark como base e, em seguida, adiciona extensões (tabelas, listas de tarefas, etc.) na parte superior. GitHub Flavored Markdown é CommonMark mais extensões do GitHub.

O desconto é gratuito?

Sim. Markdown não é software. É uma especificação. Tanto a especificação Gruber original quanto a especificação CommonMark estão disponíveis gratuitamente. O nome "Markdown" em si não é marca registrada.

Quanto tempo leva para aprender o markdown?

O básico (títulos, negrito, itálico, links, listas) leva cerca de cinco minutos. Você pode escrever descontos úteis em uma hora. Dominar a sintaxe estendida e as variações específicas da plataforma leva mais tempo, mas esta folha de dicas cobre quase tudo que você precisa.

Qual é a diferença entre markdown e rich text?

Os formatos rich text (.docx, .rtf) armazenam a formatação como dados binários ou XML junto com o texto. Markdown armazena a formatação como símbolos visíveis de texto simples. A desvantagem: o rich text oferece controle perfeito em pixels ao custo da portabilidade; markdown oferece portabilidade e velocidade ao custo de um controle refinado.