Step 1: Create a new repository and add your HTML file
 

Start by logging into GitHub and creating a new repository named exactly as you wish. After the repo is created, add an HTML file (for example, index.html).

• Click the “New” button or “+” icon in the top-right corner and choose “New repository.”
• Fill in the repository name, description (optional), and visibility, then click “Create repository.”
• On the new repo page, click “Add file” → “Create new file.” Name it index.html.

  
  


  
Hello, GitHub Pages!
  
This is a preview of my HTML file.

Commit your changes by filling in a commit message (e.g., “Add index.html”) and clicking “Commit new file.”

 
Step 2: Enable GitHub Pages
 

Configure the repository to serve HTML via GitHub Pages.

• Go to the main page of your repository.
• Click on “Settings” in the menu bar.
• Scroll down to the “Pages” section (left sidebar or under “Code and automation”).
• Under “Source,” choose the branch (main or master) and folder (usually / (root)), then click “Save.”

GitHub will display a notification indicating your site is ready, usually under a URL like https://<username>.github.io/<repo-name>/.

 
Step 3: Access and preview your HTML file
 

Wait a minute or two for GitHub Pages to build and deploy your site. Then open the URL shown in the Pages settings. For example:

https://username.github.io/repo-name/

If your file is named differently or in a subfolder, append its path:

https://username.github.io/repo-name/your-file.html

Your HTML should now render directly in the browser rather than showing raw source code.

 
Step 4: (Optional) Use a raw-file CDN for instant previews
 

If you don’t want to wait for GitHub Pages, you can use a third-party raw CDN like jsDelivr or raw.githack.com to render your HTML instantly.

• Go to your file’s “Raw” view on GitHub (click the “Raw” button while viewing index.html).
• Copy the raw URL, for example:
  https://raw.githubusercontent.com/username/repo-name/main/index.html
• Paste it into a raw CDN service:
• jsDelivr:
  https://cdn.jsdelivr.net/gh/username/repo-name@main/index.html
• raw.githack.com:
  https://raw.githack.com/username/repo-name/main/index.html

Open the CDN URL in your browser to see the HTML rendered immediately.

 
Step 5: Keep your HTML updated
 

Whenever you push new commits to the branch you configured for Pages, GitHub will automatically rebuild and redeploy your site. For quick updates via the command line:

git add index.html
git commit -m "Update content"
git push origin main

Refresh your GitHub Pages URL or CDN link to preview the latest version.

That’s it! You now know how to preview your HTML files directly via GitHub Pages or a raw-file CDN.