How to make a doc site on GitHub with HackMD
Getting started
- Clone or fork this repo on GitHub
- Change the
baseurl to your repo name in _config.yml - Open new branch named
gh-pages and push to your GitHub remote (e.g. git branch gh-pages && git push origin gh-pages) - Ensure you setup GitHub Pages source uses
gh-pages branch - Create a new note on HackMD
- Select
Pull from GitHub and select your repo, master branch and select README.md from the file dropdown then click Pull - Modify the content on HackMD (See more at: https://jekyllrb.com/docs/posts/)
- Select
Versions on the top right menu, click Push to GitHub - Fill the new Version name and click
Push - Wait for GitHub Actions build your doc site and view it on GitHub Pages!
Add a new page to doc site
- Create a new note on HackMD
- Modify the content on HackMD (See more at: https://jekyllrb.com/docs/posts/)
- Select
Push to GitHub and select your repo, master branch and create a new filename (e.g. Another-page.md) then click Push - Wait for GitHub Actions build your doc site and view it on GitHub Pages!