この記事の要点

Web / データ交換 / アプリ設定の 3 用途を担うテキストフォーマット マークアップ: HTML / CSS / SVG。データ: JSON / XML / YAML / TOML。設定: .ini / .env / .conf JSON はコメント不可・末尾カンマ不可で機械可読特化。YAML は人間可読特化（インデント命） TOML はモダン設定の主役（Rust の Cargo.toml、Python の pyproject.toml） .env はシークレット保管所。必ず .gitignore に追加すること

このカテゴリについて

Web・データ・設定系は、すべて人間が読み書きできるテキスト形式で、用途は次の 3 つに大別されます。

• マークアップ（構造化文書）: HTML / CSS / SVG / XML — ブラウザやレンダラが解釈
• データ交換: JSON / XML / YAML / TOML — システム間でデータを受け渡し
• アプリ設定: .ini / .env / .conf / .properties — アプリの動作を制御

これらは git で差分が見やすく、テキストエディタで編集できるので、Infrastructure as Code（IaC）や GitOps といった現代の運用スタイルと相性が抜群です。一方で、ヒューマンエラーで構文が崩れると即座に落ちるため、CI で jq / yq / tomlq による検証を組み込むのが定石です。

Web・データ・設定で扱う主な拡張子

拡張子	概要
.html / .htm	HyperText Markup Language。Web ページ本体
.css	Cascading Style Sheets。装飾とレイアウト
.scss / .sass	SCSS / SASS。CSS プリプロセッサ
.less	CSS プリプロセッサ（Bootstrap で使用）
.svg	Scalable Vector Graphics。XML ベースのベクタ画像
.json	JavaScript Object Notation。データ交換の事実標準
.xml	eXtensible Markup Language。歴史長く厳格
.yaml / .yml	YAML。Kubernetes / Ansible / GitHub Actions で主流
.toml	Tom's Obvious Minimal Language。Cargo.toml / pyproject.toml
.ini	INI ファイル。古典的設定形式
.conf	汎用設定ファイル。nginx.conf / httpd.conf
.env	環境変数定義。シークレットも含むので .gitignore 必須
.properties	Java の設定形式。key=value
.htaccess	Apache ディレクトリ別設定

用途別の使い分け

目的	推奨形式	理由
API レスポンス	JSON	ブラウザがネイティブパース、軽量
機械間のデータ交換（厳格）	XML	スキーマ・名前空間・XSLT
人が書く設定（複雑）	YAML	コメント可、ネスト読みやすい
人が書く設定（モダン）	TOML	YAML より曖昧性少なくシンプル
環境変数・シークレット	.env	各言語の dotenv ライブラリ対応
Apache のディレクトリ設定	.htaccess	Apache のみ、再起動不要
シンプルな key=value 設定	.ini / .properties	古いソフトで採用多

関連カテゴリ・記事

• ファイル拡張子とは（概論）
• JSON
• .env
• .htaccess
• php.ini
• web.xml
• sitemap.xml
• コンテントタイプ(Content-Type)一覧