.swiq 파일 포맷

텍스트 파일 하나로 나만의 퀴즈 세트를 만들 수 있어요. 한 줄이 카드 한 장 — 메모장에서 쓰고, 아이폰에서 열면 끝.

One line per card. Write it in any text editor, open it in Swiq.

한눈에 보기

Grammar at a glance

# 세트 제목            ← 첫 '#' 줄 = 제목 (선택)
> 설명 줄              ← '>' 줄 = 설명 (선택)
@languageCode: ko      ← 콘텐츠 언어 ko/en (선택)
// 주석                ← 무시
문장 | O | 설명(선택)
Q: 질문 | A: 답1;답2 | 설명(선택)
질문 | 1)보기 2)보기 3)보기 4)보기 | 정답번호 | 설명(선택)

세 가지 카드 문법

Three card syntaxes — O/X, short answer, multiple choice

O/X 카드

True/false card 문장 | O | 설명(선택)

정답 자리에는 O X 참 거짓 true false를 쓸 수 있어요.

주관식 카드

Short-answer card Q: 질문 | A: 답1;답2 | 설명(선택)

정답이 여러 개면 ;(세미콜론)으로 구분해요. 어느 것을 입력해도 정답으로 인정됩니다.

4지선다 카드

Multiple-choice card (4 options) 질문 | 1)보기 2)보기 3)보기 4)보기 | 정답번호 | 설명(선택)

보기는 1)~4)로 번호를 붙이고, 정답 자리에는 정답 보기의 번호를 적어요.

파일 규칙

File rules & limits

UTF-8 텍스트 파일, 확장자는 .swiq
@languageCode: ko 또는 @languageCode: en으로 콘텐츠 언어를 선택적으로 지정할 수 있어요. 생략하면 앱의 언어 선택값을 사용합니다.
빈 줄은 무시돼요 — 보기 좋게 자유롭게 띄어 쓰세요
카드가 10~200장 인식되면 가져올 수 있어요
파일 크기는 1MB 이하
문항은 500자, 설명은 2,000자까지
중복 문항은 자동으로 무시돼요

앱에서 여는 법

How to open a .swiq file on iPhone

iPhone에서 .swiq 파일을 다운로드하세요 (Safari·메신저·메일 어디서든)
파일 앱에서 파일을 열거나, 공유 시트를 띄우세요
Swiq를 선택하면 앱이 파일을 읽어들여요
미리보기에서 카드를 확인하고 저장하면 끝!

전체 예시

A complete example you can copy

# 기초 과학 O/X
> 매일 알아두면 좋은 과학 상식
@languageCode: ko

// 주석은 무시됩니다
물은 1기압에서 섭씨 100도에 끓는다. | O | 고도가 높아지면 끓는점이 낮아져요.
소리는 진공에서도 전달된다. | X
Q: '사과'를 뜻하는 영단어는? | A: apple | 기초 과일 어휘입니다.
Q: 물의 화학식은? | A: H2O;h2o
대한민국의 수도는? | 1)서울 2)부산 3)인천 4)대전 | 1 | 수도는 서울특별시입니다.

⬇ 예시 파일 다운로드 — 기초 과학 O/X (.swiq)

모든 세트 페이지에서도 각 세트를 .swiq 파일로 내려받을 수 있어요.

JSON으로도 작성할 수 있어요

You can also write a set as JSON — handy for AI generation & export

줄 포맷 대신 JSON으로도 세트를 만들 수 있어요. AI에게 생성을 시키거나, 다른 도구에서 내보낼 때 편리합니다. 줄 포맷과 JSON 중 어느 쪽이든 .swiq 파일로 저장하면 앱이 파일 내용을 보고 형식을 자동으로 알아봐요.

Save either format as a .swiq file — the app auto-detects which one it is.

JSON 스키마

JSON schema (v1)

title — 세트 제목(필수), description — 설명(선택)
languageCode — 콘텐츠 언어(선택), 값은 ko 또는 en. 생략하거나 지원하지 않는 값이면 앱의 언어 선택값을 사용합니다.
cards — 카드 배열(필수). 카드마다 type은 ox · text · choice 중 하나 (생략하면 ox)
ox: prompt + answer(참/거짓 true/false)
text: prompt + answers(정답 문자열 배열, 아무거나 맞으면 정답)
choice: prompt + choices(보기 배열) + answer(정답 보기 번호, 1부터 시작)
모든 카드에 explanation(설명)을 선택적으로 넣을 수 있어요

ox 카드

True/false {"type": "ox", "prompt": "문장", "answer": true, "explanation": "설명(선택)"}

text 카드

Short answer {"type": "text", "prompt": "질문", "answers": ["답1", "답2"], "explanation": "선택"}

choice 카드

Multiple choice — answer is 1-based {"type": "choice", "prompt": "질문", "choices": ["a", "b", "c", "d"], "answer": 2, "explanation": "선택"}

JSON 전체 예시

A complete JSON example you can copy

{
  "title": "기초 과학 O/X",
  "description": "매일 알아두면 좋은 과학 상식",
  "languageCode": "ko",
  "cards": [
    {
      "type": "ox",
      "prompt": "물은 1기압에서 섭씨 100도에 끓는다.",
      "answer": true,
      "explanation": "고도가 높아지면 끓는점이 낮아져요."
    },
    {
      "type": "ox",
      "prompt": "소리는 진공에서도 전달된다.",
      "answer": false
    },
    {
      "type": "text",
      "prompt": "'사과'를 뜻하는 영단어는?",
      "answers": [
        "apple"
      ],
      "explanation": "기초 과일 어휘입니다."
    },
    {
      "type": "text",
      "prompt": "물의 화학식은?",
      "answers": [
        "H2O",
        "h2o"
      ]
    },
    {
      "type": "choice",
      "prompt": "대한민국의 수도는?",
      "choices": [
        "서울",
        "부산",
        "인천",
        "대전"
      ],
      "answer": 1,
      "explanation": "수도는 서울특별시입니다."
    }
  ]
}

⬇ JSON 예시 다운로드 — 기초 과학 O/X (.json)

각 세트 페이지의 “.json 다운로드”로 세트를 이 스키마 그대로 내려받을 수 있어요.