Your sitemap#
Every published collection gets one:
markloom.app/u/<handle>/<collection>/sitemap.xml
It lists the index and every page, and the link is shown beside your published address in the dashboard so you can submit it to Google Search Console. You do not have to — crawlers reach the pages by following links from your index page — but submitting it is faster.
Your collection is also listed in Markloom's own sitemap index, so search engines discover it without you doing anything.
A one-page site is not indexed#
A collection has to have two or more pages before search engines are
told to index it. A single-page site is marked noindex.
This is deliberate. One-page sites are what link-spam farms publish, and a platform that lets them be indexed becomes a platform search engines distrust — which would cost every real publisher on it. Add a second page and the restriction lifts on the next save.
Share previews#
Paste a published URL into WhatsApp, Slack, iMessage or X and you get a
card: your site's title, its description, and an image generated from your
theme, accent colour and logo. Set image: in front matter or
_config.md to use your own picture instead.
Most chat apps cache a preview per URL for hours and offer no way to clear it. Check how a link looks before you send it somewhere that matters.
Search inside your site#
Sites with more than one page get a search box, and ⌘K / Ctrl+K opens
it from any page. It searches titles and body text of every page in the
collection, runs in the visitor's browser, and loads its index only when
someone actually searches.
Things worth doing#
- Give every page a
description— it is what appears under the title in results - Write real titles;
UntitledandDoc 3cost you clicks - Put your most important page first in
_toc.md - Submit the sitemap once, when the site is ready rather than half-written