Skip to content
Docs

FAQ sections

A native, zero-JavaScript FAQ block for the questions newcomers actually ask, readable by people and by AI answer engines alike.

Why

First-timers have the same handful of questions: do I need experience, is it free, how do I find the room. Answer them where people land. The FAQ block also gives AI answer engines (ChatGPT, Perplexity, AI Overviews) clean question → answer text to quote.

Note: classic FAQ rich results are not a goal. Google restricts them to government and health sites, so don’t expect snippets. The value is on-page clarity and AI-friendliness.

Authoring

## Common questions

{{< faq >}}
{{< question q="Do I need experience?" open="true" >}}
No, beginners are the point. Come as you are.
{{< /question >}}
{{< question q="Is it free?" >}}
Yes, always **free**.
{{< /question >}}
{{< /faq >}}
import FAQ from '../../components/FAQ.astro';
import FAQItem from '../../components/FAQItem.astro';

## Common questions

<FAQ>
  <FAQItem q="Do I need experience?" open>No, beginners are the point. Come as you are.</FAQItem>
  <FAQItem q="Is it free?">Yes, always **free**.</FAQItem>
</FAQ>

Answer bodies are markdown. open renders an item expanded; open the most important one. Put a normal ## Common questions heading above the block: the FAQ doesn’t emit its own. It renders native <details>, so it’s accessible and works with zero JavaScript.

Writing good answers

  • Ask questions the way people do: “Do I need a laptop?”, not “Equipment”.
  • Answer in the first sentence, elaborate after.
  • Keep answers self-contained, an AI agent will quote them without context.

A good starter set: what is this, who is it for, do I need experience, is it free, can I just watch, how do I find the room.