Why Z

中/EN

05. How to get your site indexed by search engines

2 min read

Steps

1. Deploy the site to the public web

  • GitHub Pages
  • Netlify
  • Vercel
  • Cloudflare Pages

2. **Submit to search engines

  1. Go to Google Search Console
  2. Add your site’s domain
  3. Verify ownership of the site (usually by adding an HTML file or a DNS record)

Warning

Don’t put the HTML in the root directory — put it in quartz/static

  1. Submit the Sitemap: https://your-domain/sitemap.xml Google Search Console says it couldn’t fetch This is a known issue with Cloudflare Pages. When sitemap.xml is hosted as a static asset, Cloudflare Pages may not set the Content-Type response header correctly, so Googlebot can’t parse it. Fix it by adding a _headers file. Create a _headers file in your project root:

Check the sitemap status https://httpstatus.io/

Bing Webmaster Tools

  1. Go to Bing Webmaster
  2. Add the site and verify it
  3. Submit the Sitemap

Other search engines

  • Baidu Webmaster Platform (if your target users are in China)
  • Yandex Webmaster (for Russian users)

3. Tune the Quartz config

In quartz.config.ts, make sure the SEO-related features are enabled:

plugins: {
  transformers: [
    // ... other plugins
    Plugin.Description(), // generate page descriptions
  ],
  emitters: [
    Plugin.ComponentResources(),
    Plugin.ContentPage(),
    Plugin.FolderPage(),
    Plugin.TagPage(),
    Plugin.ContentIndex(),
    Plugin.Assets(),
    Plugin.Static(),
    Plugin.NotFoundPage(),
    Plugin.Sitemap(), // make sure Sitemap is enabled
  ],
}

4. Create robots.txt

Create robots.txt in the quartz/static/ directory:

User-agent: * 
Allow: / 
Sitemap: https://your-domain/sitemap.xml

Make sure sitemap.xml exists. Visit https://your-domain/sitemap.xml — if you see lots of <url> tags, you’re good.

5. Check whether it’s indexed

Type into the search box: site:your-domain Expected timeline

  • Google: usually starts indexing in 1–4 weeks
  • Bing: usually 2–6 weeks
  • Baidu: can take 1–3 months

5. Optimization

Optimize content to improve indexing

  • Add meaningful titles and descriptions
  • Use keywords in your notes
  • Add internal links
  • Keep content updated
  • Make sure pages load fast
---
title: "xxxx"
description: "a one-line summary of the content"
tags: [xxx]
---
  • Share your site on social media
  • Post links in relevant forums or communities
  • Exchange friendly links with other sites

Backlinks