'검증 완료'가 무엇을 확인한 것인지 구분하기

YAML 검증, Markdown 미리보기, Cron 생성, JSON·SQL 정리는 개발 중 반복하는 확인 작업을 줄이기 위해 추가했습니다. 다만 화면에 결과가 나온 범위와 실제 서비스가 동작하는 범위는 다릅니다. 현재 구현을 기준으로 각 도구에서 확인할 수 있는 것과 다음에 해야 할 작업을 정리합니다.

YAML 문법 검사 뒤에는 프로그램의 설정 검사

YAML 검증기에 다음 내용을 입력하면 YAML 형식 자체는 읽을 수 있습니다.

services:
  web:
    image: nginx

현재 검증기는 js-yaml로 입력을 파싱하고 구조 정보와 선택한 JSON 출력을 보여줍니다. 들여쓰기나 따옴표 문제를 찾는 데 쓸 수 있지만, Docker·Kubernetes·GitHub Actions의 설정 항목을 모두 해석하는 것은 아닙니다. 예를 들어 services 대신 철자가 틀린 servcies를 써도 YAML 문자열 키로는 유효할 수 있습니다. js-yaml 문서

따라서 Compose 파일은 실제 프로젝트에서 추가로 검사합니다.

docker compose -f compose.yaml config --quiet

이 단계는 Compose 모델과 값 치환을 검사합니다. 통과한 뒤에도 이미지, 파일 경로, 환경 변수, 실행 명령이 자신의 서비스에 맞는지 확인해야 합니다. 전체 설정 출력에는 비밀값이 포함될 수 있으므로 공개 질문에는 필요한 부분만 가린 사본을 사용합니다. Docker config 문서

Markdown 미리보기와 게시 위치의 차이

Markdown Preview에는 짧은 제목, 목록, 링크, 코드 블록을 함께 넣어 봅니다. 줄바꿈 옵션을 바꾸면 같은 원문의 문장이 이어지거나 나뉘는 모습도 비교할 수 있습니다.

## 배포 메모

- 설정 검사
- 실행 확인

[홈으로](/)

현재 도구는 자체 변환 규칙으로 HTML을 만들므로 다른 편집기와 모든 Markdown 확장이 같다고 가정하지 않습니다. 표의 셀 안에 |가 들어가거나 중첩된 문법이 복잡하면 실제 게시 위치에서도 확인합니다. 상대 링크 역시 게시되는 주소에 따라 목적지가 달라질 수 있습니다.

HTML 다운로드는 내용의 변환 결과입니다. 미리보기 화면의 전체 테마나 사이트 CSS까지 복제하는 파일은 아닙니다. 다운로드 파일을 따로 열고 제목·목록·링크가 기대한 모습인지 확인한 뒤 사용합니다. 안전 관련 옵션 하나로 모든 외부 입력의 안전성이 검증되었다고 판단하지 않습니다.

Cron 생성 뒤에는 시간대와 등록 상태 확인

Cron 표현식 생성기는 분 시간 일 월 요일의 다섯 필드를 만듭니다. 매주 월~금 오전 9시 조건은 다음과 같습니다.

0 9 * * 1-5

매 5분은 분 칸의 */5로 표현할 수 있습니다. 분 칸에 60을 넣거나 간격을 */0으로 쓰면 현재 필드 검사에서 거부됩니다. 하지만 0 9 31 2 *처럼 각 필드 값이 허용 범위에 있어도 달력에 없는 날짜 조합까지 찾아내는 검사는 아닙니다.

이 도구는 예약 표현식을 만들며 서버에 작업을 등록하지 않습니다. 실행하려면 사용 중인 스케줄러에서 명령, 실행 계정, 작업 폴더, 환경 변수와 시간대를 설정해야 합니다. 초 필드가 있는 형식이나 Quartz 전용 기호를 같은 규칙으로 처리한다고 가정하지 않습니다.

일과 요일을 동시에 제한한 경우에는 스케줄러의 결합 규칙도 확인합니다. 일반적인 Linux crontab은 두 필드를 모두 제한했을 때 둘 중 하나가 맞는 날을 선택할 수 있어 '매월 특정 일이면서 특정 요일'이라는 의도와 달라질 수 있습니다. crontab 매뉴얼

SQL 정리 결과는 실행 전에 원문과 비교

SQL Formatter의 현재 구현은 정규식으로 공백과 키워드를 정리합니다. DB에 접속해 문법·테이블·권한을 검증하는 기능은 아닙니다. 특히 문자열 내부와 SQL 구문을 완전히 분리해 처리하지 않아 따옴표 안의 내용이 달라질 수 있습니다.

예를 들어 SELECT 'A B';의 연속 공백은 정리 과정에서 SELECT 'A B';처럼 줄어들 수 있습니다. --나 쉼표가 들어 있는 문자열도 원본과 반드시 비교합니다. 이런 쿼리는 출력 결과를 그대로 실행하지 말고 사용 DB에 맞는 파서 기반 도구에서 검토해야 합니다.

JSON 정리 역시 문법 통과가 업무 데이터의 정확성을 뜻하지 않습니다. 개발 텍스트 도구 사용 예제에서 문자열·숫자·부분 일치의 차이를 함께 확인할 수 있습니다.

2026년 9월 22일 구현 기준으로 각 단계의 검사 범위를 명시했습니다. 설정 파싱, 형식 정리, 미리보기, 실제 실행을 각각 확인하면 화면의 성공 표시를 지나치게 넓게 해석하는 일을 줄일 수 있습니다.