DEPRECATION NOTICE: This is documentation related to legacy publishing. For the latest guidance, reference the current publishing documentation.

This guide describes publishing to GitHub using GitHub Actions



  • create pages branch
  • enable GitHub Pages on pages branch
  • have package.json
  • create GitHub action
  • enable actions on your repo
  • add .nojekyll to the root of your repo
  • configure your dendron.yml
  • link CNAME with GitHub Pages
  • enforce https on your page


  1. Checkout the pages branch and push it to GitHub
git checkout -b pages
git push origin pages
  1. Switch back to your original branch
  • NOTE: if you are using old versions of GitHub, this command will be git checkout master
git checkout main
  1. Create a package.json at the root of your workspace
    "scripts": {
        "dendron-cli": "dendron-cli"
    "license": "CC BY 4.0",
    "devDependencies": {
        "@dendronhq/dendron-cli": "*",
        "@dendronhq/dendron-11ty-legacy": "*"
  1. Create the workflow .github/workflows/dendron-action.yml:
  • create the workflow
mkdir -p .github/workflows
touch .github/workflows/dendron-action.yml
  • file contents
name: Dendron

            - main

        runs-on: ubuntu-latest
            - name: Checkout source
              uses: actions/checkout@v2

            - name: Install npm dependencies
              run: npm install

            - name: Build pod
              run: npm run dendron-cli --buildSiteV2 --wsRoot .  --stage prod

            - name: Deploy site
              uses: peaceiris/actions-gh-pages@v3
                  github_token: ${{ secrets.GITHUB_TOKEN }}
                  publish_branch: pages
                  publish_dir: docs/
                  force_orphan: true
                  cname: "" # UPDATE WITH DOMAIN NAME

Make sure to update the cname: "" value above with your own domain name.

  1. Add the .nojekyll file at the base of your repo
touch .nojekyll
  1. Commit these changes and then push your main branch
git add .
git commit -m "add publishing via gh-action"
git push
  1. Update your GitHub Pages setting to build GitHub Pages from the pages branch and using the root folder.

  1. GitHub Actions will update your page every time you push. You might have to add a change and push before your changes will show up. You can verify that your action is running by clicking on the Actions tab in GitHub.
  • NOTE: depending on your account settings, you might need to enable GitHub first


Credit to Luke Carrier for his initial contributions to publishing Dendron with GitHub.