Need advice about organizing data files (yml, json, xml) for simple pages generated

Support
1

I’m building a static site with dozens of quizzes/exams (currently ~50 and growing) with hard coded HTML, and I’m finding an approach to manage them. I’ve used Jekyll before but only for simple blogs and not data related.

There are many quiz types. Here is the demo of 2 of them.
https://demobbe.netlify.app/
https://demobbe1.netlify.app/

Each exam page has a passage (300-900 words) and questions (5-15 questions).
Should I use yml, toml or json for this task?

2

Currently I’m trying Hugo Content Adapter. The syntax comprehension is difficult espcially white space management.
I wonder if Zola can do this beginner friendlier.
Thanks :folded_hands:

3

Put the body of the written passage as the content of a single blog entry.

And add the exam questions as meta of the blog post under [extra]

test1.md

+++

title = “Sample Academic Reading Multiple Choice (one answer)”
date = 2025-07-07
weight = 1

[extra]
questions = [{title=“In paragraph one, the writer suggests that companies could consider?”, selections=[{txt=“abolishing pay schemes based on age”}, {txt=“avoiding piece-rate pay”}, ]} ,

+++

The general assumption is that older workers are paid more in spite of, rather than because of, their productivity. That might partly explain why, when employers are under pressure to cut costs, they persuade a 55-year old to take early retirement. Take away seniority-base

..

In the template that is effectively html

{{page.content}} will show the text

  • {% for q in page.extra.questions %}

      q.title
    1. {% for s in q.selections %}

        s.txt

      {% endfor %}

    {% endfor %}

    • I have done that with a site that uses plenty of offsite backend code. Also an important component of that is passing in ids and so forth in buttons and divs.

    data-item-id={{q.id}}