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 은 요즘 웹이 사실상 표준으로 받아들인 기능들을 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 조합을 읽어내는 법, 그리고 새로 쓸지 남의 걸 가져다 쓸지 판단하는 법까지 익혀. JSON 을 마음 놓고 받아 쓰게 만들어 주는 층이 바로 여기야.

   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 이 짊어진 구두점을 들여쓰기와 따옴표 없는 값으로 바꿔치웠어. 그 결과 사람한텐 편해졌는데, 보기보다 까다로워. 탭은 못 쓰고, 간격 하나 어긋나면 데이터 모양이 달라지고, 'no' 라고 적은 문자열이 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 은 한구석의 포맷이었어. 지금은 production 을 굴려. 이 트랙은 개발자 월급이 걸린 YAML 들을 한 바퀴 돌아. Kubernetes manifest, Docker Compose stack, GitHub Actions workflow, Helm chart 값, OpenAPI spec, 그리고 그것들을 엮는 templating 도구 (Kustomize, Jinja, SOPS) 까지. 문법은 하나, 방언은 여섯, 그래도 익히는 건 하나의 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 과 key 라는 모델을 익히고, Rust 와 요즘 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 도 다 읽게 되면, 마지막으로 남는 기술은 그중 뭘 고를지 정하는 거야. 그리고 옮겨야 할 땐 깨끗하게 옮기는 거고. 이 트랙에서는 변환 도구들 (yq, jq, dasel, gron) 을 한 바퀴 돌고, 스트리밍에 쓰는 JSON Lines 를 보고, 한 파일에 두 포맷이 공존하는 패턴 (front matter, MDX) 을 보고, 접착제 노릇을 하는 schema 를 보고, 팀을 물어뜯는 왕복 변환 함정을 짚은 다음, 내일 바로 쓸 수 있는 결정 기준표로 마무리해.

   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 문제→