Publishing Your Garden 🌐

Once you’ve created your digital garden with Quartz, you’ll want to share it with the world! Here are the best ways to publish your garden online.

Free Hosting Options

GitHub Pages (Recommended)

Pros: Free, reliable, good performance Cost: Free Setup:

Push your Quartz project to GitHub
Enable GitHub Pages in repository settings
Set up GitHub Actions for automatic deployment

# .github/workflows/deploy.yml
name: Deploy Quartz site to GitHub Pages
 
on:
  push:
    branches:
      - main

Netlify

Pros: Easy deployment, great performance, custom domains Cost: Free tier available Setup: Connect your GitHub repo to Netlify

Vercel

Pros: Excellent performance, easy setup Cost: Free tier available
Setup: Import project from GitHub

Custom Domain Setup

Purchase a domain (Namecheap, Google Domains, etc.)
Configure DNS to point to your hosting provider
Update baseUrl in quartz.config.ts:
```
baseUrl: "yourdomain.com"
```

Automation Workflows

Obsidian → GitHub → Auto-publish

Store your Obsidian vault in Git
Use Obsidian Git plugin for automatic syncing
GitHub Actions deploys changes automatically

Local → Git → Deploy

# Daily workflow
npx quartz sync    # Sync content changes
git add .
git commit -m "Update garden"
git push           # Triggers auto-deployment

Performance Tips

Optimize images: Compress before adding to your garden
Use CDN: For better global performance
Enable caching: Most hosts do this automatically
Monitor size: Keep individual pages reasonable

SEO Considerations

Essential Meta Tags

---
title: Your Page Title
description: A brief description of the page content
tags: [relevant, keywords]
---

Site Configuration

Update quartz.config.ts:

analytics: {
  provider: "google", // or "plausible"
  tagId: "G-XXXXXXXXXX"
}

Backup Strategies

Git repositories: Primary backup
Export options: Regular markdown exports
Multiple platforms: Consider mirroring to multiple hosts

Legal Considerations

License: Add a license for your content
Privacy: Include privacy policy if using analytics
Attribution: Credit sources and inspirations

Maintenance

Regular Tasks

Update Quartz: npx quartz update
Review broken links
Update outdated content
Monitor analytics and performance

Content Strategy

Write consistently, even if briefly
Link new content to existing notes
Review and update popular pages
Gather feedback from readers

Advanced Features

Custom CSS

Create quartz/styles/custom.scss for personalization:

// Custom garden styling
.page-title {
  color: #2d5016;
}

Plugins

Explore community plugins for additional functionality

Troubleshooting

Common issues and solutions:

Build failures: Check Node.js version compatibility
Broken links: Use consistent file naming
Slow builds: Optimize image sizes, reduce plugin usage
Missing pages: Verify file extensions and frontmatter

My Notes Public

Explorer

Publishing Your Garden