# 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). ![](https://1ponto5.linhavermelha.org/img/tutorial_hackmd/sign_in.png) ## Criar Novo Documento Documentos no HackMD chamam-se *notes*. Para criar um novo *note*, clica no botão **`New Note`** na página *Home*. ![](https://1ponto5.linhavermelha.org/img/tutorial_hackmd/new_note.png) Ou, num documento já criado, clica no botão `➕` e seleciona **`Create new note`**. ![](https://1ponto5.linhavermelha.org/img/tutorial_hackmd/new_note_2.png) ## 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. ![](https://1ponto5.linhavermelha.org/img/tutorial_hackmd/view_modes.png) ## 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. ![](https://1ponto5.linhavermelha.org/img/tutorial_hackmd/invite.png) ## 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. ![](https://1ponto5.linhavermelha.org/img/tutorial_hackmd/editing_help.png) ### 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. ![](https://1ponto5.linhavermelha.org/img/tutorial_hackmd/titles_TOC.png) ![](https://1ponto5.linhavermelha.org/img/tutorial_hackmd/titles_syntax.png) ### 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: `![descrição da imagem](endereço_url_da_imagen)` Por exemplo: `![Desprendimento de gelo na Antártida](https://live.staticflickr.com/373/32062650671_ef7c9260d7_c_d.jpg)` 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: ![](https://1ponto5.linhavermelha.org/img/tutorial_hackmd/upload_picture.png) ### 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: ![](https://1ponto5.linhavermelha.org/img/tutorial_hackmd/editor_theme.png)