HackMD.io Tutorial Básico

O HackMD, sem dúvida, é um dos melhores editores online de textos no formato markdown. Crie documentos colaborativos ou particulares com facilidade e simplicidade.
(se você ainda não conhece as vantagens, clique aqui)

Aprenda a

1. Criar um documento
   • Sem login
   • Com login
2. Definir Permissões de Compartilhamento
3. Compartilhar Link para Edição
4. Publicar
5. Ver exemplos básicos de código e links para documentação avançada
6. Enviar imagens

• Método 1 (sem controle)
• Método 2 (com controle)

1. Inserir links

• Link puro
• Com texto

1. Inserir comentários internos
2. Exportar / Fazer Download
   • Exportar em MarkDown
   • Exportar em HTML
   • Expotar HTML puro (sem css, js, etc)
   • Exportar formato ODF
3. Restaurar um backup automático (Revisão)
4. Acessar o histórico

Nível

Básico / Iniciante

Tutorial HackMD

1. Criar Documento

---

a) sem login

Você não precisa estar logado. Basta acessar o site hackmd.io e clicar em "Nova nota como convidado".

b) com login

É recomendável fazer o cadastro para ter sempre salvos os seus documentos. Para isso, clique no botão [ENTRAR] e escolha através de qual plataforma fará o seu login.

Após logar, clique em "+Nova nota" para iniciar seu primeiro documento.

2. Definir Permissões de compartilhamento

---

Antes de iniciar sua edição ou passar o link para alguém, escolha as permissões do arquivo e evite problemas.

Para isso, clique no link que se encontra no canto superior direito e escolha entre:

• freely
  Qualquer pessoa com o link pode ver e editar.
• editable
  Precisa logar no HackMD para editar.
• limited
  Precisa logar no HackMD para editar. Para visualizar, precisa estar logado.
• locked
  Somente o dono pode editar, mas outros podem visualizar com o link.
• protected
  Somente o dono pode editar. Para visualizar, precisa estar logado, não basta o link.
• private
  Somente o criador do texto pode editar e visualizar.

3. Compartilhar Link para Edição

---

A edição colaborativa é um ponto forte do HackMD

Agora que já escolheu o método preferido, para compartilhar, você pode simplesmente selecionar o endereço na barra de endereços de seu navegador e enviar para as pessoas.

4. Publicar

---

Você pode deixar o seu texto no ar para ser acessado por qualquer pessoa a qualquer momento, como se fosse um site pessoal.

Lembre-se de configurar as permissões corretas, pois o link fixo também é editável, se assim você tiver configurado.

NOTA:
Se pretende editar sempre, não faça sem login.
Crie seu login no HackMD (Passo 1b) e mantenha tudo salvo.

Clique em Publicar, no menu superior direito, para obter o link fixo.

5. Help - Ver exemplos básicos

---

Aqui você encontrará alguns exemplos básicos de códigos MarkDown.

Clique no ícone de ajuda, no canto superior esquerdo do topo.

Você verá todas as possibilidades básicas em Dicas, além dos links para uma documentação mais avançada e exemplos, no menu lateral.

6. Enviar Imagens e Hospedar Automaticamente

---

a) Método 1 (fácil, mas sem controle)

Você não precisa ter um local para hospedar suas fotos. Todas ficarão publicadas no imgurl automaticamente (não recomendado).

IMPORTANTE:
Você não poderá controlar as imagens enviadas dessa forma.
Se quiser controle, escolha o Método 2 logo a baixo.

Para enviar suas fotos (sabendo que não terá controle sobre elas), basta clicar no ícone da câmera e escolher o arquivo a ser upado.

b) Método 2 (com controle total)

Hospede antes no imgur com seu próprio login, ou onde preferir, ao invés de usar o ícone de upload do HackMD.

Para inserir imagens que já estejam hospedadas no local de sua preferência, clique no ícone de imagem, no menu superior secundário e a seguir, entre os parênteses, adicione o endereço (url) da imagem.

exemplo:

![](https://imgur.com/EXEMPLO-TUTORIAL.JPG)

7. Inserir links

a) Link Puro

Como o nome já diz, basta colar ou escrever o endereço para que funcione como link.

Exemplo:

https://steemit.com/@casberp

b) Link com Texto

I. Clique no ícone da corrente, no menu superior secundário.

II. Escreva o texto do link entre colchetes e o link propriamente dito, entre os parênteses.

Exemplo:

[@casberp](https://steemit.com/@casberp)

8. Inserir comentários

---

É um recurso muito interessante adicionar comentários nos textos. Assim, todos os que forem colaborar, poderão se comunicar de forma clara.

Para adicionar comentários, clique no botão de "chat" no menu superior esquerdo secundário.

Usando o "name", que aparece como exemplo, você facilita a colaboração. Os outros usuários saberão facilmente quem adicionou o comentário. Pode virar um "chat" completo.

Veja como fica:

[name=casberp]Exemplo de comentário interno:
sugiro que blá blá blá e use o link tal para cá..
[name=colaborador]Ótimo, sugestão aceita.
[name=revisor]Não gostei, altere para blá blá devido ao problema da xpto 2.0.
[name=casberp]Feito!

9. Exportar

---

Você pode salvar seus documentos em diversos formatos. Entenda cada um deles e saiba como fazer:

• Exportar como Markdown

  Formato padrão. Salva um arquivo .md que você poderá utilizar onde preferir.

• Exportar HTML

  Isso faz com que você tenha um arquivo .html com todos os links para css e js necessários para que o visual seja idêntico ao que criou no HackMD. É visualizável perfeitamente em qualquer navegador.

• Exportar HTML puro

  HTML puro, significa que somente o código html será salvo, sem links para css e js. Isso tornará o texto um pouco diferente do que você viu no editor, mas pode ser muito útil em alguns casos.

• Exportar formato ODF

  Esse é um formato chamado Open Documment. Funciona na maioria dos editores de texto, sem problema algum. Word, LibreOffice, OpenOffice e outros.

Para exportar (baixar), clique em "Menu" no canto superior direito, e escolha um dos formatos que você acabou de conhecer.

10. Restaurar um backup (Revisão)

---

Muitas vezes você poderá cometer o erro de editar e sumir com tudo, ou apagar partes importantes do texto. No HackMD isso não é problema. Automaticamente, são salvos backups de suas alterações.

Se você errar, para restaurar é muito simples.

I. Clique no Menu superior direito, em **"Menu" **e escolha a opção "Revisão".

II. Escolha através da data, qual você quer restaurar. Clique em alguma e você pode conferir se o texto está correto, na janela da direita.

11. Acessar o Histórico

---

Mesmo estando deslogado, você pode acessar seu histórico recente. Para isso, clique no ícone do HackMD no canto superior esquerdo da tela.

A seguir, clique em Histórico.

Agora clique no "cartão" correspondente.
Cuidado ao clicar no X, pois fará sumir seu histórico e você perderá o link, mas o arquivo continuará existindo. Se perdeu o link, não será mais possível encontrá-lo.

Conclusão

---

Parabéns. Esse é o tutorial básico de HackMD.

Agora você está apto para editar, colaborar, publicar, compartilhar e salvar seus textos em formato markdown usando o HackMD.io.

MUITO EM BREVE, será publicado um tutorial semelhante, mas em vídeo, para você que prefere aprender vendo alguém fazer.

---

Espero que esse tutorial te ajude a prosperar.

Veja outros artigos e tutoriais clicando aqui.

---