Pensando no processo de aprendizado de nossos alunos e alunas, para sanar dúvidas durante algum curso ou formação, a Alura conta com um fórum interno onde instrutores, instrutoras e outros alunos podem ajudar uns aos outros compartilhando suas perguntas através de texto, trechos de códigos e imagens.
Markdown
Para postar uma dúvida ou ajudar alguém no fórum, é utilizado o Markdown, uma linguagem de marcação simples onde é possível estilizar sua pergunta.
Textos no Markdown
Para criar um parágrafo com uma ou mais linhas consecutivas de texto, não há necessidade de nenhum elemento. Veja o exemplo abaixo:
Meu código não está funcionando. Um erro é gerado na linha 3 onde faço as importações dos pacotes. Podem me ajudar?
Compartilhando código
Para indicar um intervalo de código, utilize aspas intervidas (`), como descreve o exemplo abaixo:
Minha função printf() não está funcionando.
Para incluir um intervalo de código com mais de uma linha, você pode usar três aspas invertidas (```) como delimitadores de abertura e fechamento do código, como ilustra o exemplo abaixo:
#include <stdio.h>
void fun(int x)
{
x = 30;
}
int main(void)
{
int x = 20;
fun(x);
printf("x = %d", x);
return 0;
}Compartilhando imagens
O Markdown usa uma sintaxe de imagem de duas formas diferentes: inline e referência.
Inline
A imagem será exibida no mesmo contexto da resposta, utilizando o símbolo de exclamação(!), seguido da descrição do link entre colchetes e o link da imagem entre parênteses:
Para armazenar a imagem de forma simples e gerar o link da imagem, você pode utilizar o site Imgur, clicar em New post e colar sua imagem. Em seguida, copie o link e substitua o endereço entre os parênteses.
Referência e link para outras páginas
A imagem não será exibida no mesmo contexto da resposta, e sim um link com o caminho para abrir a imagem. A única diferença será a ausência do símbolo de exclamação, como demonstra o código abaixo:
[descrição do link](link da imagem ou outra página)
Formas de estilizar sua pergunta
E o resultado será:
- Negrito
- Itálico
Riscado (Strikethrough)- https://www.alura.com.br/
Documentação oficial do Markdown
Para obter mais informações sobre o Markdown, clique neste link ou veja este vídeo do Alura+ do Paulo Silveira, que demonstra na prática como descrever melhor suas dúvidas no fórum da Alura ou em outros fóruns de tecnologia.
