COMO ESCREVER NA LINGUAGEM MARKDOWN

• Markdown é uma Linguagem de Texto que serve para organizar Documentos em Repositórios e Empresas.
• Ela é muito fácil de aprender e utilizar e todo esse Site foi feito em Markdown, onde o Gitlab pega os Arquivos com extensão .md e transforma nesse Texto Organizado que você está vendo.

GLOSSÁRIO

• CRIANDO ABA DE TELAS

• COLOCANDO TEXTO EM NEGRITO

• COLOCANDO TEXTO EM ITALICO

• MARCANDO TEXTO ESPECIFICO

• CRIANDO TABELAS

• TITULOS

• DIVISAO DE TEXTOS

• SEPARANDO TEXTOS

• COLOCANDO CÓDIGO NO TEXTO

• LINK DE ACESSO RÁPIDO

• COLOCANDO MARCAÇÃO DE TECLADO

• COLOCANDO CÓDIGO HEX DE CORES

• COLOCANDO CORES EM LETRAS NO GITHUB PAGES

• EMOJIS

• Markdown é uma Linguagem de Texto que estrutura como o Texto vai aparecer, essa Wiki toda é feita utilizando essa linguagem.

• Existem estruturas especificas para usar quando escreve em Markdown, onde podemos inventar coisas interessantes com elas.

CRIANDO ABA DE TELAS

| * Podemos criar um Header com todos os Links vinculando telas, onde usamos a seguinte estrutura

[]()
|---|

• O simbolo []() serve para colocarmos o nome da tela(nos []) e o link para o Markdown da tela(nos ()).
• O simbolo |---| serve para estruturar esse link como em uma Aba, onde cada link deve ter um desses.
• Exemplo em Markdown:

[Página Inicial](Home)|[Aulas do Professor](Aulas_Professor)
|---|---|

• Exemplo na prática:

COLOCANDO TEXTO EM NEGRITO

• Podemos colocar o texto que estamos escrevendo em negrito usando ** em cada lado do texto.
• Exemplo em Markdown:

**Texto**

• Exemplo na Prática: Texto

COLOCANDO O TEXTO EM ITÁLICO

• Podemos colocar o texto que estamos trabalhando em itálico usando _ em cada lado do texto.
• Exemplo em Markdown:

_Texto_

• Exemplo na prática: Texto

MARCANDO TEXTO ESPECIFICO

• Se usar ` em cada lado do texto vai fazer com que o texto fique sublinhado
• Exemplo em Markdown:

`Texto`

• Exemplo na prática: Texto

CRIANDO TABELAS

• Podemos criar facilmente tabelas, onde somente temos que dividir em colunas usando |.
• Para marcar o titulo das Colunas, devemos embaixo de cada titulo colocar |---|
• Exemplo em Markdown:

Primeia Coluna | Segunda Coluna
|---|---|
Linha 1, Coluna 1| Linha 1, Coluna 2
Linha 2, Coluna 1| Linha 2, Coluna 2

• Exemplo na Prática:

TÍTULOS

• Podemos colocar um Título em cada página da Wiki usando uma # antes de cada titulo
• Quanto mais # colocamos, menor o título vai ficando
• Exemplo em Markdown:

# Titulo Maior
## Sub-titulo Menor
### Menor ainda
#### Menor ainda

• Exemplo prático:

Titulo Maior

Sub-titulo Menor

Menor ainda

Menor ainda

DIVISÃO DE TEXTOS

• Usamos os Símbolos --- antes e depois de um texto para deixar ele separado do resto
• Exemplo em Markdown:

---

Texto Separado

---

• Exemplo na prática:

Texto Separado

SEPARANDO TEXTOS

• Como você pode ter percebido, existe um ponto escuro no inicio de cada linha de texto, esse ponto é um * colocado no inicio de cada linha de texto, onde com ele podemos separar o texto em tópicos.
• Quando mais * forem colocado com um espaço ele vai criando sub-tópicos para um assunto.
• Exemplo em Markdown:

* A
    * A.1
        * A.1.1
            * A.1.1.1

• Exemplo Prático:

• A

  • A.1
    • A.1.1
      • A.1.1.1

• Podemos também usar números, colocando um ponto do lado do número

• Exemplo em Markdown:

1. A
    1. A.1
2. B
    1. B.1
        1. B.1.1

• Exemplo na Prática:

1. A
   1. A.1
2. B
   1. B.1
      1. B.1.1

COLOCANDO CÓDIGO NO TEXTO

• Uma coisa incrivel do Markdown é que podemos fazer highlight de código usando a seguinte estrutura em Markdown:

• Sempre coloque o nome da linguagem que deseja fazer highlight depois dos primeiros ```

• Na prática fica assim:

public class Teste{
    public static void main(String[] args){
        System.out.println("Hello World"):
    }
}

LINK DE ACESSO RÁPIDO

• Podemos colocar uma tag em uma área do Texto para o sistema ir mais rápido até o conteúdo se ele for muito extenso.
• Criamos a estrutura de Links, mas de vez de enviarmos para outro arquivo marcamos este arquivo e criamos um nome Alias para utilizar.
• Exemplo:

[Arquivos](../Utilizando-a-wiki/escrevendo-em-markdown#linkAcessoRapido)

• O que vem depois do nome gereniando_wiki (que deve ser o nome deste arquivo markdown) e do # é uma Alias que poderemos usar em qualquer parte do nosso Código.
• Para chamar o Alias, devemos usar a seguinte tag:

<a name="linkAcesspRapido"></a>

• Dessa forma, podemos colocar o Link no inicio desse Arquivo(que já existe) e ele vai enviar o arquivo direto para onde se encontra a tag, salvando tempo de ficar procurando texto.

COMO MARCAR TECLAS DO TECLADO EM MARKDOWN

• Existe uma tag de html que podemos usar para deixar diferenciado uma tecla de teclado, para facilitar o entendimento do que se deve fazer.
• Utilizamos a seguinte tag

<kbd>L</kbd>

• No exemplo acima, a tecla L vai ficar diferenciada no texto, sendo fácil de entender que ela é uma tecla do teclado.

• Ex: Como abrir um Terminal Linux no Teclado: Ctrl + Alt + T

MOSTRANDO CORES NO MARKDOWN

• Podemos utilizar o Código de Cores Hexadecimais para aparecer em um comentário de uma Issue em Markdown, só devemos colocar a # e o código da cor dentro de ``.
• Abaixo uma visualização de como é:

`#FFD700`

• Se deseja conhecer mais cores, clique nesse Site: https://www.color-hex.com/

SISTEMA DE CORES DE FONTES NAS PAGINAS DO GITHUB PAGES

Agora irei mostrar como colocar cores nos textos do Markdown

OBS: isso funciona em arquivos comuns de Markdown e no Github Pages, nas Wikis do Github infelimente essa tag não funciona

iremos usar a tag <code> para podermos determinar a cor de um texto

<code style="color : nome_cor">Texto desejado</code>

Existem várias cores que Podemos usar, para isso mostrarei a tabela abaixo:

EMOJIS

• Podemos colocar Emojis em Markdown, somente passando o código dele Abaixo a lista de todos os Emojis que o Github aceita:

People

Nature

Objects

Places

Symbols