Este projeto é uma API de um projeto que, com auxilio da API REST oficial do GitHub, permite aos usuários acessar e gerenciar suas anotações em Markdown armazenadas em qualquer repositório do usuário de forma prática e eficiente.
O projeto é ideal para usuários que utilizam o GitHub como um repositório de backups e sincronização para anotações, como os usuários do Obsidian ou LogSeq. Ambos apps com funções de sincronização de arquivos pagas, porém com plugins que tornam a sincronização através do GitHub possível.
Através do MD Notes, você pode acessar suas anotações de qualquer dispositivo, seja um smartphone ou outro computador. Com simplicidade e facilidade uso.
O objetivo principal do MD Notes é oferecer uma maneira intuitiva de acessar e, brevemente, gerenciar suas anotações armazenadas em repositórios do GitHub, podendo então acessar tais anotações escritas em markdown através de qualquer dispositivo de forma gratuita e facilitadora.
Muitos usuários enfrentam limitações com softwares de anotações em markdown que possuem um plano pago para dar acesso a funcionalidade de sincronização entre dispositivos. O MD Notes visa resolver este problema ao proporcionar uma integração direta com o GitHub, atuando como um micro-serviço entre o GitHub e o seu software de anotações favorito, permitindo a leitura e gestão dos arquivos Markdown de maneira descomplicada.
- Registro de Dados: Permitir o registro dos dados necessários para o uso da API do GitHub.
- Listagem de Arquivos: Exibir a lista de arquivos presentes no repositório do GitHub.
- Listagem de Pastas: Exibir a lista de pastas presentes no repositório do GitHub.
- Navegação em Pastas: Permitir o acesso e visualização de arquivos dentro das pastas.
- Acesso a Arquivos Markdown: Exibir o conteúdo dos arquivos Markdown (apenas leitura).
- Segurança dos Dados: Armazenar dados do usuário em cookies HTTP Only para garantir segurança.
- Arquitetura Escalável: Construir a aplicação com uma arquitetura que permita futuras expansões e melhorias.
- Documentação Completa: Garantir que a API esteja totalmente documentada para fácil integração e uso.
- Validação de Dados: Rejeitar requisições com dados inválidos para a API do GitHub.
- Descriptografia: Garantir que o conteúdo dos arquivos Markdown seja descriptografado corretamente para exibição.
- Suporte Exclusivo: Suportar apenas arquivos Markdown.
COMING SOON...
| Tecnologia | Uso |
|---|---|
| JavaScript | Linguagem usada |
| NodeJS | Runtime JS usada |
| Express | Servidor HTTP |
| Valibot | Validação de alguns dados |
| Eslint | Formatação e padronização de código |
| Prettier | Formatação e padronização de código |
| Husky | Execução de comandos antes de commits |
| Lint-Staged | Execução de scripts somente em arquivos staged |
A documentação da API pode ser acessada através da rota /api/docs na porta padrão do projeto (3000).
OBS: A documentação está na versão inicial, sendo assim será atualizada após a refatoração do código.
- LinkedIn: www.linkedin.com/in/antonio-mauricio-4645832b3
- Instagram: https://www.instagram.com/antonioalmeida2003/
- Email: antonioimportant@gmail.com