- Qual variante de Markdown ele renderiza?
- CommonMark, mais as partes do GitHub Flavored Markdown que as pessoas de fato usam num README: tabelas com barras verticais, listas de tarefas com caixas de seleção, tachado com til duplo, blocos de código com rótulo de linguagem e URLs soltas transformadas em links automaticamente. Títulos no estilo Setext — um título com sinais de igual ou hífens embaixo — também funcionam, porque muitos READMEs antigos são escritos assim. Notas de rodapé, listas de definição e blocos de matemática ainda não estão; são uma pequena minoria dos documentos e cada um é um dialeto diferente.
- Meu documento é enviado para algum lugar?
- Não. O parser roda no seu navegador, na página que você já carregou. Nada é enviado a um servidor, e é por isso também que não há conta: não há nada a que ligar uma. Seu rascunho fica guardado no armazenamento local do navegador, no seu próprio aparelho, então sobrevive a uma recarga e a uma aba fechada, e não segue você para outra máquina.
- Por que o HTML do meu documento aparece como texto em vez de renderizar?
- É de propósito. O Markdown tecnicamente permite HTML inline, e todo editor que renderiza isso vira um lugar onde colar o README de outra pessoa pode rodar o script dela no seu navegador. Este escapa o HTML do texto e mostra como texto visível, e remove URLs javascript: e data: de links e imagens. Se o que você quer é HTML a partir de Markdown, o conversor de Markdown para HTML dá o código-fonte para copiar — é outra tarefa e outra ferramenta.
- Qual a diferença entre este editor e o conversor de Markdown para HTML?
- Este mostra um documento renderizado para ler; o conversor dá código-fonte HTML para colar em outro lugar. Mesma entrada, coisa diferente do lado direito. Se você está conferindo como um README vai ficar, você quer esta página. Se vai colar o resultado num CMS ou num modelo de e-mail, você quer o conversor. Também há uma ferramenta de HTML para Markdown se você estiver indo na direção contrária.
- Como o tempo de leitura é calculado?
- Número de palavras dividido por 200 palavras por minuto, arredondado para cima, com mínimo de um minuto para qualquer coisa que não esteja vazia. Duzentos é o número que a maioria das editoras usa para leitura adulta de prosa comum; documentos técnicos com código são lidos mais devagar na prática, então trate como um piso, não uma promessa. A própria contagem de palavras entende Unicode em vez de só dividir por espaços, o que importa para textos em chinês e japonês, em que não há espaços para dividir.
- A contagem de caracteres lida bem com emoji?
- Sim. Um emoji de família como 👨👩👧 é um único caractere aqui, mesmo sendo feito de vários pontos de código unidos — a contagem usa segmentação de grafemas, a mesma coisa que o seu cursor usa quando anda pelo texto um toque por vez. Contadores ingênuos mostram esse mesmo emoji como oito caracteres, e é por isso que limites de caracteres em outros lugares se comportam de um jeito tão estranho quando você cola um.
- Qual o tamanho máximo de documento?
- A prévia ao vivo vai até 100.000 caracteres, o que dá mais ou menos um documento de 15.000 palavras — muito além de qualquer README. Passando disso, a prévia para em vez de reprocessar um romance a cada tecla, a mensagem avisa, e seu texto fica exatamente onde está e continua editável. Um documento de 2.000 caracteres renderiza em poucos milissegundos, então a digitação nunca fica para trás.
- Os dois painéis rolam juntos?
- Numa tela larga, sim — rolar qualquer painel move o outro proporcionalmente, então o parágrafo que você está editando fica mais ou menos em frente ao parágrafo que está lendo. É proporcional, não linha a linha, então um documento com uma imagem alta ou um bloco de código longo vai desalinhar um pouco; é a troca honesta por uma sincronização que nunca pula do nada.
- Posso guardar mais de um documento?
- Não — um documento, uma tarefa. Vários documentos significam uma lista de arquivos, e uma lista de arquivos significa dar nome, apagar e, no fim, uma conta para sincronizar. Todo grande editor de Markdown começou exatamente aí e acabou virando um workspace em que você precisa fazer login. Se precisar de dois documentos, abra duas abas ou guarde os arquivos no seu próprio disco com o botão Baixar.
- Funciona no celular?
- Sim. Abaixo de 768 pixels, os dois painéis viram uma alternância Escrever / Prévia sobre o mesmo documento, então nada fica espremido numa coluna estreita demais para ler e não há rolagem lateral. Tabelas e blocos de código rolam na horizontal dentro da própria caixa em vez de alargar a página.
