🌐 Como Subir Seu Primeiro Arquivo HTML no GitHub (Guia Passo a Passo para Iniciantes)

Se você criou seu primeiro arquivo HTML e quer mostrar seu site para o mundo, o GitHub é o lugar certo!
Mesmo que você nunca tenha usado Git antes, neste guia fácil você vai aprender como subir seu projeto HTML para o GitHub — começando com git init e terminando com git push.

---

💡 O que é Git e GitHub?

• Git é uma ferramenta que guarda o histórico do seu projeto (quem mudou o quê, e quando).

• GitHub é um site que guarda esse histórico online e permite que você compartilhe ou trabalhe com outras pessoas.

Pense assim:

Git = seu controle de versão
GitHub = a nuvem onde seu código vive 🌤️

 

 

📝 1. Crie um arquivo HTML simples

Dentro da pasta, crie um arquivo chamado index.html com este conteúdo:

🪄 2. Inicie o Git

Agora diga ao Git que ele deve começar a acompanhar essa pasta:

Isso cria um repositório local (ou seja, no seu computador).

---

📦 3. Adicione e salve o arquivo

Adicione o arquivo ao controle de versão e salve a primeira versão:

O ponto (.) significa “adicionar todas as mudanças”.

☁️ 4. Crie um repositório no GitHub

1. Vá até https://github.com

2. Clique em New Repository

3. Dê o nome meu-site (ou o que preferir)

4. Não adicione README, .gitignore ou licença — vamos enviar tudo do computador.

Depois que o repositório for criado, copie o link.

Ele vai ser algo como:

🔗 5. Conecte o repositório local ao GitHub

No terminal:

🚀 6. Envie seu projeto para o GitHub

Agora é hora de subir o arquivo HTML:

💡 Dica: se sua branch principal for “master”, troque “main” por “master”.

Pronto!

Seu arquivo index.html agora está no GitHub 🎉

Se você já tem um projeto HTML no GitHub e quer atualizá-lo — por exemplo, fez mudanças no seu index.html ou adicionou novos arquivos — o processo é bem simples.

Vamos ver o passo a passo completo 👇

✏️ 7. Faça as alterações

Abra o arquivo HTML no seu editor (por exemplo, VS Code) e mude o que quiser.

Exemplo: alterando o título no index.html:

💾 8. Verifique o que mudou

Depois de salvar, veja o que foi alterado:

O Git mostrará os arquivos modificados, algo como:

➕ 9. Adicione as alterações

Diga ao Git que quer incluir essas mudanças no próximo “snapshot”:

O ponto (.) significa “adicionar todas as mudanças”.

🧱 10. Crie um novo commit

Salve suas alterações com uma mensagem descritiva:

Cada commit é como uma versão salva do seu projeto — assim, você pode voltar no tempo se algo der errado.

☁️ 11. Envie para o GitHub

Agora é só enviar (fazer o push):

🔧 12. Outros comandos úteis

📥 Git Clone — copiar um projeto existente

Se você quiser baixar um repositório do GitHub para o seu computador:

Isso cria uma cópia local do projeto.

🔁 Git Pull — atualizar o projeto local

Se você quiser trazer as mudanças mais recentes do GitHub:

🔀 Git Merge — juntar alterações de diferentes versões

Se você estiver trabalhando em uma nova branch (ex: nova-pagina) e quiser juntar com a principal:

Isso combina as alterações das duas versões do projeto.

🏁 Conclusão

Você acabou de aprender o básico do Git e do GitHub usando um projeto HTML simples!
Agora você sabe:

✅ Iniciar um repositório com git init
✅ Salvar mudanças com git add e git commit
✅ Enviar arquivos para o GitHub com git push
✅ Atualizar e unir projetos com git pull e git merge

Daqui pra frente, você pode colocar seus projetos web no ar com o GitHub Pages e mostrar suas criações para o mundo 🌍