When to avoid GitHub pages

GitHub Pages isn’t suited for many kinds of sites. Here are some examples where you wouldn’t want to use it.

  • All GitHub Pages sites are public, even if the Git repository they’re based on is private. So don’t use GitHub Pages if you ever plan to include any private information in your Markdown files
  • Don’t use GitHub pages for sites that require any kind of data from the user. GitHub Pages sites are read-only. You can’t use them to collect usernames, passwords, or any other kind of data
  • GitHub pages isn’t too useful for sites with complex formatting needs