설정 파일 서식

TOML 포맷터설정을 설명하는 주석도 함께 유지

원문을 남겨 둔 채 구문과 테이블 위치를 확인하고 출력 서식을 정리합니다.

TOML 포맷터

TOML 입력

서식 결과

내용은 이 브라우저에만 머뭅니다. 입력을 업로드, 실행, 저장하거나 URL에 추가하지 않습니다.

정렬은 기본적으로 꺼져 있습니다. 연속된 키 그룹만 정렬하며 주석은 해당 키를 따릅니다. 배열과 테이블 순서는 그대로입니다.

TOML 1.0.0 · dprint TOML 0.8.0 · toml-eslint-parser 1.0.3. 구문 검사는 앱 스키마를 확인하지 않습니다.

입력 UTF-16 500,000단위 / UTF-8 2MB, 노드 50,000개, 깊이 100, 출력 200만 문자, 작업 제한 5초.

테이블 탐색

TOML을 입력하거나 검사를 실행하세요.

TOML 포맷터는 설정값 옆에 적은 설명을 지우지 않고 파일을 읽기 쉽게 만듭니다. 결과가 별도 영역에 나오므로 공백과 키 순서의 변화를 살펴본 후 입력을 바꿀 수 있습니다.

TOML 검증만 필요하면 검사만 실행하세요. TOML 정렬은 원하는 키 그룹에만 적용합니다. TOML 주석, 여러 줄 문자열과 반복되는 배열 테이블을 줄 모양이 아닌 실제 구문으로 해석합니다.

TOML 포맷터를 사용하는 이유

설명의 연결과 구조를 함께 확인

설명과 설정을 함께 보존

TOML 포맷터는 일반 객체로 변환하면서 잃기 쉬운 독립 주석과 행 끝 주석을 유지합니다. 정렬하면 항목에 붙은 설명도 함께 움직이고 빈 줄로 구분한 그룹 제목은 해당 그룹 위에 남습니다.

두 종이의 색상 항목이 짝을 이루는 주석 태그와 함께 재배열되는 모습.

실제 테이블로 바로 이동

목록은 입력에 실제로 있는 테이블 헤더와 반복 배열 테이블의 각 위치를 보여 줍니다. 삼중 따옴표 문자열 안에 있는 대괄호 줄을 잘못된 탐색 대상으로 만들지 않습니다.

세 탐색 지점이 실제 색상 헤더로 연결되고 회색 문자열 속 가짜 헤더는 연결되지 않은 모습.

원문 교체 전에 확인할 사항

알아 두면 유용한 세 가지 조작

01

검사와 서식 작업 구분

검사만 실행하면 대기 중인 자동 작업을 취소하고 현재 입력을 확인합니다. 테이블 탐색은 가능하지만 서식 결과를 만들지 않아 내보낼 수 없습니다. 다시 입력하면 자동 서식이 재개됩니다. 수동 모드에서는 서식 버튼이나 Ctrl/Cmd+Enter를 쓰세요.

02

원본 위치로 이동

테이블 항목이나 첫 오류를 누르면 입력의 해당 행과 열로 이동합니다. 배열 테이블은 등장할 때마다 별도 항목이 되며 목록은 50개씩 더 볼 수 있습니다. 이 표시 제한이 다운로드 내용을 자르지는 않습니다.

03

미리보기에서 교체 적용

결과 사용, 예제, 지우기, UTF-8 파일 선택은 먼저 교체할 내용과 줄 수를 보여 줍니다. 적용 후 한 번 되돌려 입력, 옵션, 결과와 이전 오류까지 복원할 수 있습니다. 편집을 시작하면 지난 결과의 내보내기는 바로 비활성화됩니다.

서식 선택을 직접 확인

TOML 값의 자료형을 유지

주석을 이해하는 처리

따옴표 키, 여러 줄 문자열, 인라인 테이블과 주석을 구문 트리로 처리합니다. 출력 전후의 값과 주석 내용을 비교하며 보존 검사를 통과하지 못하면 불완전한 파일을 제공하지 않습니다.

범위를 정한 키 정렬

기본값은 원래 순서 유지입니다. 정렬을 켜면 빈 줄로 나뉜 연속 키 그룹을 정렬하고 연결된 주석도 옮깁니다. 배열 요소, 인라인 테이블 키, 일반 테이블과 배열 테이블의 순서는 바꾸지 않습니다.

들여쓰기와 줄바꿈 선택

공백 2칸, 4칸 또는 탭, 권장 너비 80·100·120열, LF·CRLF를 선택합니다. 너비는 배치 기준이며 긴 문자열이나 주석을 반드시 그 안에 맞추지는 않습니다.

현재 결과만 저장

자동 모드는 편집 후 350ms를 기다리고 취소 가능한 로컬 worker에서 처리합니다. 수동 모드에는 서식 버튼이 표시됩니다. 복사와 UTF-8 다운로드는 같은 최신 결과를 사용합니다.

구문과 보존, 처리량의 한계

검사 성공의 의미를 정확히 확인

TOML 1.0.0 기준
toml-eslint-parser 1.0.3에 TOML 1.0.0을 지정하고 dprint TOML 0.8.0으로 서식을 정리합니다. TOML 1.1 전용 구문은 범위 밖입니다. 중복 키나 구문 오류는 첫 진단의 행·열을 표시하며 모든 오류를 한꺼번에 나열하지 않습니다.
바이트 단위 복제는 아님
큰 정수, 고정밀 숫자 표기, 날짜·시간, 여러 줄 문자열, NaN과 inf를 보존합니다. 주석 내용과 연결은 유지하지만 행 끝 공백 정리나 빈 줄 배치는 달라질 수 있습니다. 보존 검사가 실패하면 출력을 중단합니다.
정렬 범위는 키 그룹
빈 줄로 떨어진 독립 그룹 제목은 그룹 위에 남고 나머지 앞쪽 주석과 행 끝 주석은 항목을 따릅니다. 테이블, 배열 테이블, 배열 요소나 인라인 테이블 키는 정렬하지 않으며 Cargo 전용 규칙도 적용하지 않습니다.
앱의 규칙까지 검증하지 않음
구문이 맞는 pyproject.toml이나 Cargo.toml에도 알 수 없는 필드, 의존성 조건 오류나 앱이 기대하지 않는 자료형이 있을 수 있습니다. 스키마, 빌드, 의존성 확인이나 자동 복구를 하지 않습니다. 주석을 설정 명령으로 실행하거나 외부 요청에 사용하지 않습니다.
텍스트 또는 파일 하나
붙여 넣은 텍스트나 UTF-8 파일 하나를 받습니다. LF와 CRLF는 지원하지만 단독 CR은 유효한 TOML 1.0 줄바꿈이 아닙니다. URL 가져오기, 공유 링크, 입력 기록, 폴더 일괄 처리와 원본 자동 덮어쓰기는 없습니다.
크기와 복잡도 제한
입력은 UTF-16 500,000단위와 UTF-8 2MB 이내, 노드 50,000개와 깊이 100까지입니다. 출력은 200만 문자, worker는 엔진 로딩을 포함해 5초입니다. Unicode·구문·크기·보존 오류는 내보내기를 막고 취소는 현재 작업을 폐기합니다.

TOML 포맷터 자주 묻는 질문

중첩 구조, 날짜와 긴 문자열

중첩된 테이블 배열도 지원하나요?

네. TOML 포맷터는 TOML 1.0.0 구문으로 해석하고 배열 테이블의 순서를 보존합니다. 이름이 같은 헤더도 각 등장 위치를 따로 표시하므로 목록에서 구별해 이동할 수 있습니다.

날짜와 시간 값이 바뀌지는 않나요?

날짜·시간 리터럴을 일반 문자열로 재생성하지 않고 유지합니다. TOML 포맷터는 처리 전후 보존을 검사하지만 그 날짜가 앱의 업무 규칙에 맞는지는 검증하지 않습니다.

삼중 따옴표로 쓴 긴 문자열도 가능한가요?

여러 줄 기본 문자열과 리터럴 문자열 모두 지원합니다. 문자열 속 대괄호와 해시 문자를 테이블이나 주석으로 오인하지 않고 실제 문자열 내용으로 보존합니다.

설정 파일에서 YAML 대신 TOML을 쓰는 이유는 뭔가요?

TOML은 테이블과 값이 명시적이며 YAML과 구조 표현 방식이 다릅니다. 다만 파일 형식은 사용하는 앱의 요구를 따라야 합니다. 이 페이지는 형식을 바꾸는 대신 TOML 구문과 서식을 다룹니다.

붙여 넣은 내용을 따로 보관하나요?

입력 기록을 저장하지 않으며 브라우저 worker에서 처리합니다. 엔진 파일을 받는 요청에도 입력 내용은 포함되지 않습니다. 다운로드를 누르면 새 파일이 만들어지고 원본 파일은 그대로 남습니다.

확인이 필요한 주석이나 테이블 배치가 있나요?

TOML 포맷터로 검토하기

TOML 포맷터로 주석, 테이블 위치와 선택한 정렬을 확인한 다음 프로젝트 설정을 교체하세요.

구문 검사는 프로젝트 자체 검증을 대신하지 않습니다.