diff --git a/.github/workflows/publish_docs.yaml b/.github/workflows/publish_docs.yaml
index ebdeb5d32..490163eb9 100644
--- a/.github/workflows/publish_docs.yaml
+++ b/.github/workflows/publish_docs.yaml
@@ -17,8 +17,6 @@ permissions:
 jobs:
   build-deploy:
     runs-on: ubuntu-latest
-    permissions:
-      contents: write
     steps:
       - name: Check out repository
         uses: actions/checkout@v4
@@ -28,12 +26,18 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Build Docs
+      - name: Install Quartodoc dependencies
+        run: pip install .[docs]
+
+      - name: Qartodoc Build
+        run: quartodoc build --config docs/_quarto.yam
+
+      - name: Render Docs
         uses: quarto-dev/quarto-actions/render@v2
         with:
           path: docs/
 
-      - name: Publish Docs
+      - name: Publish Rendered Docs
         # if: github.event_name == 'release'
         uses: quarto-dev/quarto-actions/publish@v2
         with:
diff --git a/.gitignore b/.gitignore
index f8e3ff60f..4de78366e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -105,11 +105,3 @@ venv.bak/
 
 .idea
 src/tiledb/cloud/version.py
-
-# Quarto
-/.quarto/
-reference/
-_site/
-## Quarto interlinks
-objects.json
-_sidebar.yml
diff --git a/docs/.gitignore b/docs/.gitignore
index 075b2542a..44f341313 100644
--- a/docs/.gitignore
+++ b/docs/.gitignore
@@ -1 +1,7 @@
 /.quarto/
+_build
+reference
+
+# interlinks
+objects.json
+_sidebar.yml
diff --git a/docs/_quarto.yaml b/docs/_quarto.yaml
index ed823ee5f..503dabeca 100644
--- a/docs/_quarto.yaml
+++ b/docs/_quarto.yaml
@@ -1,5 +1,6 @@
 project:
   type: website
+  output-dir: _build
 
 website:
   # title: "Cloud-Py"