Esteja você está postando No Reddit, Discord ou Github, há apenas uma maneira de adicionar formatação: Markdown. Se você deseja adicionar um link, em negrito algum texto ou até mesmo dividir o texto em parágrafos, precisará conhecer o básico deste sistema de formatação baseado em texto.
Isso parece assustador? Confie em mim, não é. O Markdown possui apenas algumas regras para formatar o texto da maneira que você deseja, e você só precisa aprender as regras para a formatação que realmente usa.
Vamos analisar as regras simples, falar sobre por que o Markdown é útil e, em seguida, dê uma olhada em alguns recursos que você pode usar para ir mais longe com o Markdown.
O básico do Markdown
O Markdown é uma maneira de aplicar uma formatação rica ao texto simples, adicionando certos caracteres a ele. Em plataformas como Discord ou Reddit, onde as mensagens são curtas e relativamente simples, você realmente só precisa aprender alguns princípios básicos:
- Para itálico texto, coloque um asterisco antes e depois dele, *assim *
- Para audacioso texto, coloque dois asteriscos antes e depois dele, ** assim **
- Para incluir um link, coloque o texto do link em colchetes seguidos imediatamente pelo URL entre parênteses (assim) (https://justinpot.com/)
- Para adicionar uma imagem, comece com um ponto de exclamação, com o suporte quadrado contendo uma descrição da imagem e os parênteses contendo um link para um arquivo de imagem ,! (como este) (https://justinpot.com/wp-content/uploads/2024/07/ima_02d2bc6.jpg)
- Para iniciar um novo parágrafo, pressione Enter duas vezes, para que haja uma linha clara entre a linha atual de texto e a próxima.
As cinco dicas acima são mais do que suficientes para coisas como Reddit e Discord. Mesmo que você esteja digitando o que parece código, quando sua postagem é publicada, tudo o que você verá é a formatação de texto rico, completo com links e imagens.
Se você estiver usando o Markdown para escrever documentos inteiros, precisará de algumas ferramentas específicas de documentos. Aqui estão os principais:
- Para fazer um cabeçalho (como o texto em grande parte “o básico do Markdown” visto acima neste artigo) inicie uma linha de texto com um sinal de libra seguido de um espaço, # como este.
- Para fazer cabeçalhos menores, use mais sinais de libra, ## como este para H2 ou ### como este para H3 e assim por diante. Quanto mais sinais de libra você adicionar, menor será o texto do cabeçalho.
- Para criar uma lista com marcadores, basta iniciar uma linha de texto com um asterisco seguido por um espaço, * como este. Você pode adicionar tantas linhas com marcadores à sua lista quanto quiser.
- Para recuperar um item da lista, coloque uma guia antes do asterisco. Para recuar ainda mais, basta adicionar mais guias.
- Para criar uma lista numerada, inicie uma linha de texto com um número e um período, 1. Assim.
- Para recuperar um item de lista numerada, adicione uma guia antes do número. Para recuar ainda mais, basta adicionar mais guias.
- Para adicionar uma cotação de bloco ao seu documento, basta iniciar um link de texto com um sinal “maior que”,> como este.
Isso cobre a maior parte do que você precisa saber para escrever um documento no Markdown. Se você estiver confuso sobre a aparência dessa formatação, ajuda a brincar e ver os resultados. Um ótimo site para fazer isso é MarkDownLivePreview.com. O painel esquerdo mostra o Markdown enquanto o lado direito mostra como isso ficará. Experimente coisas diferentes lá um pouco e você se sentirá muito mais confortável.
Por que usar o Markdown?
Tudo isso pode fazer você perguntar: por que os sites estão forçando as pessoas a aprender uma maneira ligeiramente esotérica de formatar o texto? E a resposta é que esse sistema, mesmo que um pouco confuso no começo, seja muito direto e claro quando você se acostuma.
A maioria das pessoas se acostuma a escrever em um computador usando ferramentas como o Microsoft Word ou o Google Docs. Existem os dois processadores de texto, o que significa que eles são criados para representar uma página impressa na tela. Os dois também são chamados de editores “o que você vê é o que você obtém” – ou editores da Wysiwyg – querem que a formatação seja mostrada diretamente na tela. Se você ousado algum texto, verá -lo como em negrito na tela; Se você adicionar um link, verá o texto vinculado ficar sublinhado e ficar azul como faria em uma página da web. Não há como dizer, olhando para o próprio texto, onde começa e termina em negrito ou qual é o destino do link.
Isso pode parecer intuitivo e, para ser justo, há uma simplicidade nisso. Mas essa simplicidade é possível pelo código que o usuário não vê, e o fato de o código ser mantido nos bastidores pode ser confuso de alguma maneira. Qualquer pessoa que tenha tentado adicionar algumas palavras ao final de um link, ou logo após um link, sabe que essa ambiguidade pode ser frustrante – você acabará acidentalmente tornando o link mais longo do que pretendia ou fazendo o oposto e adicionando texto que não está vinculado. Isso não acontece enquanto escreve em Markdown, porque você pode ver claramente onde toda a formatação começa e termina.
Os arquivos de marcação também são à prova de futuro. Como toda a formatação, vinculação e estrutura de documentos de texto é escrita em texto sem formatação, um formato que não mudou há décadas e não é de propriedade de nenhuma empresa, você pode ter certeza de que qualquer pessoa que encontre um arquivo de marcação em 50 anos será capaz de entender isso. O mesmo não pode ser dito sobre os arquivos do Microsoft Office.