Guia de Markdown

Markdown do dia a dia

# Título do documento

## Seção

**Negrito**, *itálico* e ~~removidos~~.

- Primeiro item
- Segundo item

1. Primeiro passo
2. Segundo passo

- [x] Concluído
- [ ] Próxima tarefa

| Recurso | Status |
| --- | --- |
| Pré-visualização ao vivo | Pronto |
| Recuperação local | Pronto |

[Exemplo](https://example.com)

![Texto alternativo](https://example.com/image.png)

Use `inline code`.

```js
const message = "Hello";
```

A área é $A = \pi r^2$.

$$
E = mc^2
$$

```mermaid
flowchart LR
  A[Escrever] --> B[Prévia]
  B --> C[Salvar um arquivo]
```

Abrir e salvar documentos

Use Arquivo → Abrir arquivos ou arraste e solte arquivos .md, .markdown ou .txt na área de trabalho. Cada arquivo é aberto em sua própria aba; o documento atual não é substituído. Novos documentos começam em branco. Arquivos UTF-8 de até 2 MiB são suportados, com até 20 abas.

Salvar grava em um arquivo local selecionado quando o navegador oferece suporte a isso e a permissão é concedida. Caso contrário, inicia um download em Markdown. Uma solicitação de download não confirma que um arquivo foi salvo no disco. Salvar como permite escolher um novo destino. Após recarregar a página, um arquivo previamente aberto deve ser aberto novamente para restabelecer o salvamento direto.

A recuperação do navegador não é um backup de arquivos.

A recuperação salva os documentos abertos e o estado das abas neste navegador. Todos os idiomas da interface compartilham o mesmo espaço de trabalho. O ponto em uma aba registra as alterações desde a última vez que um arquivo foi salvo ou uma solicitação de download de Markdown, e não o status de recuperação do navegador.

A navegação privada, a remoção de arquivos de armazenamento e a limpeza de dados do site podem eliminar cópias de recuperação. Salve documentos importantes em arquivos. Fechar uma aba modificada solicita confirmação; fechar todos os documentos remove suas cópias de recuperação após a confirmação. Alterações não salvas em outra aba do navegador não são mescladas automaticamente.

Um espaço de trabalho confortável

Use os controles da segunda linha para alternar entre a visualização dividida, somente código-fonte e somente pré-visualização. Na visualização dividida, a pré-visualização acompanha apenas a rolagem intencional do editor. Rolar a pré-visualização ou digitar no código-fonte não move o outro painel. A posição de leitura é preservada pela correspondência dos blocos Markdown à medida que o conteúdo muda; grandes reescritas e seções excluídas usam um bloco próximo que permaneceu no mesmo lugar. Desative o recurso de acompanhamento para painéis totalmente independentes.

O botão de estrutura de tópicos abre os títulos do documento sem uma barra lateral permanente. O menu de configurações oferece os temas Sistema, Claro e Escuro, um controle deslizante de tamanho de texto de 14 a 24 px, fonte monoespaçada ou sem serifa do sistema, números de linha e opções de renderização. As opções de tamanho de texto existentes são mantidas; novos espaços de trabalho têm como padrão 16 px. O botão de exemplos oferece trechos de código pesquisáveis com as opções Copiar e Inserir. O botão de tabela abre um seletor de colunas por linhas; a contagem de linhas selecionadas inclui o cabeçalho. Ctrl/Command + F pesquisa o código-fonte. Use a tecla Tab para sair do editor e as teclas de seta para navegar entre os botões de formatação.

Para documentos com mais de 250.000 unidades de código UTF-16 ou 10.000 quebras de linha, a pré-visualização automática é pausada para preservar a capacidade de resposta à digitação. Use a opção Atualizar pré-visualização para uma atualização manual. A edição e o salvamento em Markdown continuam disponíveis.

Equações

Equações em linha usam $...$ ou \(...\). Equações em bloco usam $$ em linhas separadas, ou \[ e \] em linhas separadas. O código entre crases nunca é tratado como uma equação. Escape um símbolo de moeda como \$ quando ele puder ser confundido com uma equação.

O renderizador KaTeX local suporta um subconjunto de LaTeX, não documentos .tex completos. A saída utiliza MathML nativo. Há um limite de 100 expressões renderizadas e 4.000 caracteres por expressão. Comandos não suportados ou inseguros mantêm seu código-fonte em vez de executar scripts ou carregar recursos externos.

Diagramas Mermaid

Um bloco de código delimitado com a etiqueta mermaid é renderizado localmente quando a renderização de diagramas está ativada. Nenhum diagrama é enviado a um serviço em nuvem. O renderizador é executado em uma sandbox de origem opaca, sem acesso à rede nem ao armazenamento.

É possível renderizar até 24 diagramas de 12.000 caracteres cada. Um limite de 200 arestas e prazos de renderização oferecem proteção adicional. Diretivas de configuração e frontmatter de configuração YAML dentro de um diagrama são rejeitados. Diagramas inválidos ou não suportados permanecem legíveis como código-fonte.

Transfira sua escrita para outro aplicativo.

A opção "Copiar Markdown" copia o código-fonte. A opção "Copiar HTML" copia a marcação HTML portátil, mantendo equações e diagramas como código-fonte. A opção "Copiar texto formatado" fornece HTML mais texto simples, adequado para colar títulos, ênfases, listas e tabelas em aplicativos que aceitam conteúdo rico da área de transferência. A formatação exata depende do aplicativo de destino; diagramas e equações permanecem como código-fonte para compatibilidade com a área de transferência.

A opção Exportar HTML gera um documento independente com equações MathML locais e imagens de diagramas formatadas, quando a renderização é bem-sucedida. Não requer scripts do IT Drawer. Imprimir/Salvar como PDF utiliza a caixa de diálogo de impressão do navegador; o salvamento em PDF depende do sistema operacional. Imagens Markdown externas permanecem bloqueadas, a menos que você as permita explicitamente para esse documento.

Uso e instalação offline

Selecione Arquivo → Offline e instalar e, em seguida, Ativar modo offline quando conectado. Isso prepara o editor para todos os idiomas da interface e as bibliotecas de renderização. Os arquivos offline são independentes da recuperação de documentos. A instalação pelo navegador ou a opção Adicionar à Tela Inicial são opcionais.

Aguarde até que o menu indique que o uso offline está pronto antes de desconectar. O espaço de trabalho Markdown é compatível com o modo offline, mas imagens remotas, este guia e outras ferramentas do IT Drawer não estão incluídos. O armazenamento do navegador não é permanente. As atualizações aguardam o fechamento das janelas do editor; elas não recarregam um documento ativo.

A remoção do cache offline cancela o registro apenas dos processos Markdown e remove somente os caches de seus aplicativos. Os documentos de recuperação são mantidos. Feche todas as janelas do editor após a remoção. Para apagar também os documentos, feche-os no editor ou limpe os dados do navegador do site.