# Introdução ao HackMD

O HackMD é uma ferramenta de edição de texto, colaborativa e online, que ainda permite a partilha pública de documentos.

Para começar, cria uma conta através do botão verde **`Sign In`** (também podes fazer log-in através de uma conta de google ou facebook, entre outros).


## Criar Novo Documento

Documentos no HackMD chamam-se *notes*. Para criar um novo *note*, clica no botão **`New Note`** na página *Home*.


Ou, num documento já criado, clica no botão `➕` e seleciona **`Create new note`**.


## Modo de Visão

Os *notes* são editados através do seu código fonte. Ao escrever alguma coisa no código, vais ver o resultado formatado aparecer ao mesmo tempo.

Podes ver o *note* em três modos diferentes:
- _Editar_ - Ver apenas o código fonte.
- _Ver_ - Rever o *note* formatado.
- _Ambos_ - Ver o código fonte ao lado do resultado formatado.


## Partilha e Permissões

Por defeito, qualquer pessoa com conta no HackMD consegue editar o teu *note*, se tiver acesso ao seu *link*. Altera isso no menu de Partilha, em *Write*, para `Owners`, para que apenas os "donos" do documento consigam editar o *note*.

Caso trabalhes em grupo, uma pessoa do grupo tem que convidar os outros elementos, para que toda a gente possa trabalhar em conjunto no *note*. Convida os teus colegas através do seu nome de utilizador ou email.


## Editar *Notes*

Podes formatar o conteúdo do teu *note* através dos atalhos na barra de ferramentas, ou escrevendo diretamento com a sintaxe correta. Para encontrar uma lista da sintaxe para qualquer formatação, clica no botão de ajuda.


### Títulos

É possível organisar os teus conteúdos com títulos, ao começar a linha com `#`, gerando também uma lista dos conteúdos no lado esquerdo do documento. Podes criar subtítulos com dois ou mais símbolos de cardinal.


### Links

Os *links* são feitos através do formato: `[texto do link](endereço url)`

### Inserir Imagens

Podes inserir imagens usando o mesmo formato de um *link*, com `!` à frente:
``

Por exemplo:
``

Para obteres o url da imagem que queres colocar, clica com o botão direito na imagem e seleciona "copiar *link* da imagem".

Caso queiras fazer *upload* de uma imagem do teu computador, podes usar a ferramenta do HackMD para fazer isso:

### Inserir Vídeo

Vídeos no YouTube ou Vimeo podem ser inseridos usando o formato: `{%youtube id_do_vídeo %}`

Por exemplo, para o vídeo [https://www.youtube.com/watch?v=KN768uQidKo](https://www.youtube.com/watch?v=KN768uQidKo):
`{%youtube KN768uQidKo %}`

Ou para [https://vimeo.com/161045147](https://vimeo.com/161045147):
`{%vimeo 161045147 %}`

### Cor do Editor

Podes alterar o tema do editor do código no botão em baixo: