Markup Quest

Tracks

1. 01📝Markdown 기초 — 평문이 서식 있는 글처럼 읽힌다

   0/8 lessons

   CommonMark 가 먼저. 나머진 다 방언.

   Markdown 의 여덟 빌딩 블록 — 헤딩, 문단, 강조, 리스트, 링크, 코드, 인용, 가로선. 'README 처럼 보이는 거' 추측러가 아니라 CommonMark 화자로 익히자.

   Lesson list (8)

   • 01
     Markdown 이 뭐야 — 그리고 왜 안 사라지나~10 min · markdown, commonmark, history
   • 02
     헤딩 — # 부터 ###### 까지~10 min · markdown, headings, structure
   • 03
     문단과 줄 바꿈~10 min · markdown, paragraphs, whitespace
   • 04
     강조 — bold, italic, strikethrough~10 min · markdown, emphasis, inline
   • 05
     리스트 — 순서 없음, 순서 있음, 중첩, 태스크~12 min · markdown, lists, tasks
   • 06
     링크와 이미지~12 min · markdown, links, images, accessibility
   • 07
     코드 — inline 과 fenced block~10 min · markdown, code, syntax-highlighting
   • 08
     인용, 가로선, escape~10 min · markdown, blockquotes, escaping

   ✓퀴즈 · 5 문제→

2. 02⚡Markdown 심화 & GFM — 이제 다들 'Markdown' 이라 부르는 그 맛

   0/8 lessons

   테이블, task, alert, footnote, 수식, mermaid — 사실상 표준이 된 GitHub 확장.

   GitHub Flavored Markdown 은 modern web 이 표준으로 받아들인 기능들을 CommonMark 에 더해. PR 마다 쓰는 테이블과 task. 문서를 프로페셔널하게 만드는 footnote 와 alert. README 를 publishing pipeline 으로 만드는 front matter, 임베디드 HTML, 수식, mermaid.

   Lesson list (8)

   • 01
     테이블 — 파이프, 정렬, 그리고 한계~12 min · markdown, gfm, tables
   • 02
     Task 리스트 — 진짜로 commit 되는 체크박스~10 min · markdown, gfm, tasks, github
   • 03
     Strikethrough, autolink, inline 참조~10 min · markdown, gfm, strikethrough, autolinks
   • 04
     Footnote — 흐름 안 끊는 메모~10 min · markdown, footnotes, pandoc
   • 05
     Alert — > [!NOTE], [!WARNING], 그리고 친구들~10 min · markdown, gfm, alerts, callouts
   • 06
     Front matter — 파일 맨 위 YAML/TOML/JSON~12 min · markdown, front-matter, yaml, static-sites
   • 07
     Markdown 안의 HTML — 힘과 위험~12 min · markdown, html, security, xss
   • 08
     수식, Mermaid, 다이어그램 임베드~12 min · markdown, math, katex, mermaid, diagrams

   ✓퀴즈 · 5 문제→

3. 03📦JSON 기초 — 엄격함이 설계 자체

   0/8 lessons

   JavaScript Object Notation, API 와 config 의 lingua franca.

   JSON 의 본질은 엄격함. 여섯 타입, 큰따옴표 문자열, 주석 없음, trailing comma 없음. 규칙을 익히면 어떤 API payload 든, npm/cargo/composer 매니페스트든, VS Code settings 파일이든 자신 있게 읽고 쓰고 디버깅할 수 있어.

   Lesson list (8)

   • 01
     JSON 이 뭐야, 그리고 왜 이겼나~10 min · json, history, interchange
   • 02
     여섯 타입 — 그리고 빠진 것들~10 min · json, types, spec
   • 03
     문자열 — 항상 큰따옴표~10 min · json, strings, escapes, unicode
   • 04
     숫자 — IEEE 754 의 경고들~10 min · json, numbers, ieee754, precision
   • 05
     객체 — 키는 항상 문자열~10 min · json, objects, keys
   • 06
     배열 — 순서 있음, 이종 허용, trailing comma 금지~10 min · json, arrays, ordering
   • 07
     공백, pretty-print, compact~10 min · json, whitespace, pretty-print, jq
   • 08
     흔한 버그와 디버깅 도구~12 min · json, debugging, validation, tooling

   ✓퀴즈 · 5 문제→

4. 04🔧JSON 심화 & Schema — 데이터를 위한 계약

   0/8 lessons

   JSON Schema, $ref, oneOf, 그리고 신뢰하는 모든 config 파일 뒤의 schema.

   JSON Schema 가 'JSON 문서' 를 '계약을 따르는 JSON 문서' 로 바꿔. tsconfig, package.json, OpenAPI 뒤의 schema 를 읽고; 직접 작성하고; allOf/oneOf/anyOf 조합을 이해하고; 직접 schema 작성할지 재사용할지 알게 돼. 이게 JSON 을 안전하게 소비하게 만드는 layer 야.

   Lesson list (8)

   • 01
     JSON Schema, 한 페이지로~12 min · json-schema, validation, draft-2020-12
   • 02
     type, properties, required — 세 일꾼~10 min · json-schema, type, properties
   • 03
     제약 — 길이, 범위, 패턴, 포맷~12 min · json-schema, constraints, validation, regex
   • 04
     배열 — items, uniqueItems, contains~10 min · json-schema, arrays, items
   • 05
     객체 — additionalProperties, patternProperties~10 min · json-schema, objects, additional-properties
   • 06
     조합 — allOf, oneOf, anyOf, not~12 min · json-schema, composition, polymorphism
   • 07
     $ref 와 $defs — 재사용 가능한 조각~12 min · json-schema, ref, defs, reuse
   • 08
     현장의 스키마 — package.json, tsconfig, OpenAPI~12 min · json-schema, openapi, tsconfig, schemastore

   ✓퀴즈 · 5 문제→

5. 05⚙️YAML 기초 — 들여쓰기가 곧 문법

   0/8 lessons

   YAML Ain't Markup Language — Kubernetes, Docker Compose, GitHub Actions, Ansible 을 굴리는 사람-친화 JSON superset.

   YAML 은 JSON 의 구두점 부담을 들여쓰기와 bare 값으로 대체. 결과는 사람한테 친절하고 보기보다 까다로움 — 탭 금지, 잘못된 간격은 데이터 모양 바꾸고, 'no' 라고 쓴 string 은 boolean 이 돼. 규칙을 익히면 YAML 은 가장 읽기 쉬운 config 포맷.

   Lesson list (8)

   • 01
     YAML 이 뭐고, 이미 어디 쓰고 있나~10 min · yaml, history, config
   • 02
     들여쓰기 — 스페이스만, 항상~10 min · yaml, indentation, whitespace
   • 03
     스칼라 — string, number, boolean, null~12 min · yaml, scalars, strings, norway
   • 04
     리스트 & 맵 — block 스타일과 flow 스타일~10 min · yaml, lists, maps, flow-style
   • 05
     멀티라인 string — | literal vs > folded~12 min · yaml, strings, block-scalars
   • 06
     Anchor & alias — DRY YAML~12 min · yaml, anchors, aliases, merge-keys
   • 07
     주석과 multi-document 파일~10 min · yaml, comments, multi-document
   • 08
     Linting & validation — yamllint, schema, tooling~10 min · yaml, linting, validation, yamllint

   ✓퀴즈 · 5 문제→

6. 06🚀YAML 심화 & 실전 — 출시하는 config

   0/8 lessons

   Kubernetes, Docker Compose, GitHub Actions, Helm, OpenAPI — 같은 YAML, 여섯 dialect.

   10 년 전 YAML 은 niche 포맷이었어. 오늘은 production 을 굴려. 이 트랙은 개발자 월급 내는 YAML 모양 투어: Kubernetes manifest, Docker Compose stack, GitHub Actions workflow, Helm chart 값, OpenAPI spec, 그리고 그것들 묶는 templating 도구 (Kustomize, Jinja, SOPS). 같은 문법, 여섯 dialect, 한 literacy.

   Lesson list (8)

   • 01
     Kubernetes manifest — apiVersion, kind, spec~12 min · yaml, kubernetes, manifests
   • 02
     Docker Compose — service, network, volume~12 min · yaml, docker, compose
   • 03
     GitHub Actions — workflow, job, step~12 min · yaml, github-actions, ci
   • 04
     Ansible playbook — YAML 의 idempotent ops~10 min · yaml, ansible, automation
   • 05
     Helm — Kubernetes 용 templated YAML~12 min · yaml, helm, kubernetes, templating
   • 06
     OpenAPI — YAML 의 API 계약~12 min · yaml, openapi, api
   • 07
     애플리케이션 config — pydantic, dataclass, env override~10 min · yaml, config, pydantic, dataclass
   • 08
     암호화된 YAML, 템플릿팅, CUE 대안~10 min · yaml, sops, kustomize, cue

   ✓퀴즈 · 5 문제→

7. 07🎯TOML — Tom's Obvious, Minimal Language

   0/8 lessons

   pyproject.toml, Cargo.toml, Hugo 가 하는 방식의 config.

   TOML 은 설계상 config 우선. Tom Preston-Werner 가 YAML 과 JSON 둘 다 실패한 포맷으로 만듦: 모호하지 않고, 명시적이고, 읽기 쉽고, 쓰기 쉬움. table-and-key 모델 익히고, 왜 Rust 와 modern Python 이 채택했는지 보고, YAML 위 TOML 잡을 시점 알아.

   Lesson list (8)

   • 01
     TOML 이 뭐야, 그리고 왜 Rust + Python 이 골랐나~10 min · toml, config, history
   • 02
     Key 와 값 — bare, quoted, dotted~10 min · toml, keys, syntax
   • 03
     String — 네 형태, 한 규칙 (항상 quote)~10 min · toml, strings
   • 04
     Number, boolean, 날짜 — 네이티브 타입~10 min · toml, numbers, dates
   • 05
     배열 — 동종 관행, 1.0 에서 유연~10 min · toml, arrays
   • 06
     Table — 섹션, 중첩, inline~12 min · toml, tables, sections
   • 07
     Array of table — 반복 구조 항목~10 min · toml, arrays-of-tables
   • 08
     현장의 TOML — pyproject, Cargo, Hugo~12 min · toml, pyproject, cargo, hugo

   ✓퀴즈 · 5 문제→

8. 08🔀Format Interop & 패턴 — 맞는 도구 고르기

   0/8 lessons

   변환할 때, 공존할 때, 그리고 네 포맷 다 한 literacy 로 생각하는 법.

   Markdown, JSON, YAML, TOML 다 읽고 나면 마지막 기술이 그 사이 고르기 — 그리고 변환해야 할 때 깨끗하게. 이 트랙은 변환 toolchain (yq, jq, dasel, gron) 투어, 스트리밍용 JSON Lines, polyglot 패턴 (front matter, MDX), 접착제로서의 schema, 팀을 무는 round-trip 함정, 그리고 내일 적용 가능한 결정 매트릭스로 끝.

   Lesson list (8)

   • 01
     네 포맷, 한 데이터 모델~10 min · interop, comparison
   • 02
     변환 도구 — yq, jq, dasel, gron~12 min · interop, yq, jq, tools
   • 03
     JSON Lines — 줄당 한 JSON 값~10 min · json, jsonl, ndjson, streaming
   • 04
     Polyglot 패턴 — front matter, MDX, 임베디드 JSON~10 min · interop, front-matter, mdx, polyglot
   • 05
     접착제로서의 schema — 포맷 가로지르는 JSON Schema~10 min · interop, json-schema, validation
   • 06
     라운드트립 함정 — 주석, 순서, coercion~10 min · interop, round-trip, pitfalls
   • 07
     파이프라인 — 포맷 가로지르는 데이터 wrangling~10 min · interop, pipelines, yq, jq
   • 08
     맞는 포맷 고르기 — 결정 매트릭스~12 min · interop, decision-matrix, summary

   ✓퀴즈 · 5 문제→