Do Markdown a um PDF pronto para compartilhar

1. Comece pelo seu Markdown

Cole seu texto no editor ou abra um arquivo .md, .markdown ou .txt. Comece com um título de documento descritivo e depois use seções para organizar o restante. Suas edições atualizam a pré-visualização enquanto você digita; não há uma etapa separada de salvar ou atualizar para pré-visualizar as alterações. Em telas menores, use as abas de editor e pré-visualização para alternar entre escrever e revisar.

Guarde uma cópia do Markdown original. Se você experimentar um modelo, confira o conteúdo antes de exportar para que o texto de exemplo não acabe no seu documento final.

2. Use títulos e ênfase com critério

Escreva um título principal com um único # seguido de espaço. Use ## para seções principais e ### para subseções. Envolva uma palavra em dois asteriscos para negrito ou um para itálico; três aplicam ambos. Mantenha marcadores correspondentes em cada lado. Adicionar asteriscos extras repetidamente dificulta a leitura do texto de origem e pode alterar a forma como o analisador o interpreta.

# Resumo do projeto

## O objetivo

Deixe o **ponto importante** claro.
Use *ênfase* com moderação, ou ***combine as duas***.

- Primeira ação
- Segunda ação

Deixe uma linha em branco entre parágrafos e ao redor de listas. Uma quebra de linha no texto de origem nem sempre é um novo parágrafo no PDF. Títulos consistentes também tornam um sumário gerado automaticamente mais útil.

3. Mantenha tabelas e código fáceis de ler

Tabelas são úteis para comparações curtas. Inclua uma linha separadora abaixo dos nomes das colunas e mantenha cada célula concisa. Uma tabela larga que parece confortável em um monitor pode ficar apertada no papel. Divida uma comparação grande em tabelas menores ou mova explicações longas para o parágrafo abaixo.

| Tarefa | Status |
| --- | --- |
| Rascunho | Concluído |
| Revisão | Em andamento |

```javascript
const total = 3 * 4;
console.log(total);
```

Use blocos de código cercados para exemplos de várias linhas e crases para um comando curto embutido no texto. Encurte linhas de código muito longas antes de exportar; a página impressa não pode se expandir horizontalmente como o seu editor.

4. Adicione imagens que pertencem ao documento

Uma imagem usa um ponto de exclamação, um texto descritivo entre colchetes e sua origem entre parênteses. Substitua o endereço de exemplo abaixo pelo da sua própria imagem. A ferramenta Imagens também permite escolher um PNG, JPEG, GIF ou WebP local e incorporá-lo ao Markdown. Escreva um texto alternativo útil em vez de deixar um nome de arquivo sem explicação.

![Cronograma do projeto com três marcos](https://example.com/timeline.png)

Confira se todas as imagens aparecem antes de baixar o PDF. Uma imagem remota pode exigir permissão ou ficar indisponível; um caminho de arquivo local do seu computador não fica automaticamente disponível para o servidor de exportação. Prefira imagens em tamanho adequado a originais muito grandes.

Diagramas, matemática e quebras de página

Um bloco cercado com a linguagem mermaid vira um diagrama. TeX entre cifrões simples é matemática em linha, e entre cifrões duplos em linhas próprias é uma fórmula centralizada. Uma linha contendo apenas \newpage força uma nova página. Um bloco de front matter bem no topo define o título, subtítulo, autor, data e palavras-chave usados pela capa e pelas propriedades do PDF.

---
title: Especificação do serviço de pagamento
author: Sam
---

```mermaid
flowchart LR
  A[Pedido] --> B[Cobrança] --> C[Recibo]
```

A espera após a tentativa $n$ é $w_n = 2^n \cdot 250$ ms.

\newpage

Os diagramas são desenhados no seu navegador e enviados junto com a solicitação do PDF, então nada sobre o diagrama fica armazenado no servidor.

5. Defina o layout da página antes da revisão final

Escolha A4, A5 ou Letter e, depois, selecione o estilo de documento Limpo, Editorial ou Técnico. Essas configurações alteram o documento exportado. Margens confortáveis, compactas e amplas oferecem pontos de partida rápidos; margens personalizadas permitem ajustar cada borda em milímetros. Deixe espaço para cabeçalhos e rodapés recorrentes, se você os usar.

Ative um sumário para documentos mais longos; ele usa os três primeiros níveis de título. Revise os números de página e qualquer texto de marca ou logotipo. Alternar o site entre modo claro e escuro é uma preferência de leitura, não um pedido para imprimir o documento em fundo escuro.

6. Exporte, inspecione e baixe

Gere o PDF quando a pré-visualização estiver boa. A pré-visualização em tempo real é útil durante a edição; o PDF gerado é a verificação final de quebras de página, posicionamento de imagens e conteúdo recorrente. Abra-o e inspecione a primeira página, uma página com tabela e a última página antes de compartilhar.

O texto normal do documento permanece selecionável no PDF. O MDPress deriva o nome do arquivo de download do seu primeiro título principal, recorrendo a outro título ou à primeira linha não vazia. Por exemplo, “Resumo do projeto” vira “resumo-do-projeto.pdf”. Escolha um título claro para que o arquivo faça sentido fora da sua pasta de downloads.

Problemas comuns de formatação para conferir

Se a formatação parecer errada, procure um bloco de código não fechado, marcadores de ênfase sem par ou uma linha em branco faltando. Se o conteúdo parecer apertado, encurte células de tabela ou ajuste o formato da página e as margens. HTML bruto é tratado como texto, e o front matter YAML no início é removido; use os controles do documento para as opções de impressão suportadas em vez de esperar que HTML incorporado ou front matter configurem a exportação.

Para onde vão seu rascunho e sua exportação

O texto do rascunho, as configurações e os predefinidos salvos usam o armazenamento local deste navegador. Eles não são um backup na nuvem e podem desaparecer se você limpar os dados do navegador. A exportação envia seu Markdown e as configurações do documento ao servidor do MDPress para gerar o PDF. Baixe uma cópia em Markdown quando quiser um arquivo de origem reutilizável, especialmente antes de trocar de dispositivo.