Skip to content

chris-mercer/docs-with-hackmd

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

How to make a doc site on GitHub with HackMD

Getting started

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

Add a new page to doc site

  1. Create a new note on HackMD
  2. Modify the content on HackMD (See more at: https://jekyllrb.com/docs/posts/)
  3. Select Push to GitHub and select your repo, master branch and create a new filename (e.g. Another-page.md) then click Push
  4. Wait for GitHub Actions build your doc site and view it on GitHub Pages!

About

Make a doc site on GitHub with HackMD!

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • CSS 92.0%
  • JavaScript 4.1%
  • HTML 3.9%