기본 콘텐츠로 건너뛰기

머신 리더블 문서란? RAG를 해 보니 HWP·PDF부터 막혔다 (AI-Ready와 차이) [AI 친화 문서 1편]

요즘 생성형 AI를 활용한 사업을 구축하고 있다. RAG도 그렇고, AI가 좀 더 정확한 지식으로 답하게 하려면 결국 기존 문서들을 머신 리더블(기계판독 가능) 문서로 바꾸는 작업이 필요하더라..

문제는 회사에서 나오는 문서 대부분이 HWP, DOC, PDF라는 거다. 그래서 머신 리더블 문서가 정확히 뭔지, 단계가 있다는데 어떤 단계인지, 요즘 같이 들리는 'AI-Ready 데이터'와는 같은 말인지 정리해 둔다.


머신 리더블 문서, 한 줄로 말하면

사람이 아니라 기계(프로그램, AI)가 내용과 구조를 정확하게 읽을 수 있는 문서다. 화면에 보이는 게 똑같아도 기계 입장에서는 전혀 다를 수 있다.

같은 표라도사람이 볼 때기계가 볼 때
스캔 PDF 속 표잘 보인다그림 한 장. 글자를 읽으려면 OCR이 필요하다
텍스트 PDF 속 표잘 보인다글자는 나오지만 칸이 섞여서 어느 값이 어느 열인지 모른다
마크다운 표잘 보인다행과 열이 그대로 구분된다

RAG는 문서를 잘게 나눠(청크) 검색한 뒤 그 내용을 근거로 답한다. 처음에 글자와 구조를 잘못 읽으면, 검색도 답변도 그 오류를 그대로 물려받는다.


레벨이 있다: 5-Star 오픈 데이터

"머신 리더블에도 레벨이 있다"는 말의 원조는 월드와이드웹을 만든 팀 버너스리의 5-Star 오픈 데이터다. 별이 하나씩 늘 때마다 아래 단계를 모두 포함한다.

등급뜻예
★웹에 공개만 되어 있다 (형식 상관없음)PDF
★★기계가 해석할 수 있게 구조화돼 있다 (스캔 이미지는 아님)엑셀
★★★특정 회사 프로그램에 묶이지 않는 개방 형식이다CSV
★★★★W3C 표준으로 각 항목에 주소(URI)를 붙인다RDF
★★★★★다른 데이터와 서로 연결돼 있다Linked Data

다만 이건 원래 데이터용 등급이다. 보고서나 보도자료 같은 문서에 대한 공식 레벨은 아직 없다. 그래서 문서에 맞춰 단계를 다시 나눠 봤다.


문서로 바꿔 보면: 0단계부터 5단계까지

문서의 머신 리더블 단계 0단계부터 5단계
단계형식기계 입장
0단계스캔 PDF, 사진그림이다. OCR부터 해야 한다
1단계텍스트 PDF글자는 뽑히지만 표, 단, 머리말이 섞인다
2단계HWP, DOC바이너리 형식이라 전용 프로그램이나 변환 도구가 필요하다
3단계HWPX, DOCXXML 기반 개방형 형식. 제목, 표 구조가 파일 안에 남는다
4단계마크다운, HTML제목 계층과 표가 텍스트로 그대로 보인다. RAG에 넣기 좋다
5단계구조화 데이터 + 메타데이터JSON·CSV에 작성일, 출처, 버전까지. AI-Ready로 가는 출발점

이 기준으로 보면 우리 회사 문서는 대부분 1~2단계에 있다.

RAG에 제대로 쓰려면 적어도 4단계까지는 올려야 한다.

HWPX는 한컴의 XML 기반 문서 형식(국가표준 KS X 6101)이고, DOCX도 XML 기반이라 같은 HWP·DOC라도 'X'가 붙은 형식으로만 저장해도 한 단계 올라간다.


공공 분야도 움직이고 있다

  • 행정안전부 보도자료 (2026년 4월 발표): 보도자료를 HWPX·PDF 첨부 대신 웹 게시글로 바로 볼 수 있게 바꾸고, AI와 사람이 모두 읽기 쉬운 마크다운 내려받기도 지원하겠다고 했다. AI가 첨부 파일을 직접 읽기 어려워 검증되지 않은 자료를 참조하는 문제를 줄이려는 취지다.
  • 「공공데이터의 인공지능 친화적 관리 가이드라인 V1.0」 (행정안전부·NIA, 2026년 3월): CSV, JSON, XML 같은 기계가 읽기 쉬운 형식을 권장하고, HWP·DOCX·XLSX 같은 특정 프로그램 형식은 1차 제공 형식으로 권장하지 않는다.

정부 보도자료가 마크다운으로 나온다는 건, 앞으로 문서의 기본 독자가 사람만이 아니라는 뜻이다.


그럼 AI-Ready 데이터와는 같은 말일까?

머신 리더블과 AI-Ready 데이터의 관계

나도 헷갈렸는데, 같은 말은 아니다. 머신 리더블은 AI-Ready의 1층이다.

머신 리더블AI-Ready 데이터
질문기계가 읽을 수 있나?AI가 바로 쓸 수 있나?
보는 것형식과 구조형식 + 품질, 메타데이터, 표준 코드, 라벨, 라이선스, 관리 체계
관계필요조건머신 리더블 위에 쌓는 것

TTA 정보통신용어사전은 AI-Ready(인공지능 준비) 데이터를 "학습, 분석 및 추론에 바로 활용할 수 있도록 데이터의 품질, 구조, 라벨, 메타데이터, 접근성 및 거버넌스 요건을 갖춘 데이터"로 정의한다. 기계가 읽을 수 있어도 결측이 많거나, 날짜 형식이 제각각이거나, 무슨 값인지 설명이 없으면 AI-Ready라고 할 수 없다. 이 부분은 다음 편에서 자세히 정리한다.


기존 문서는 그렇다 쳐도, 새 문서부터는

기존 문서를 전부 바꾸는 건 쉽지 않다. 실제로 다른 프로젝트와 협업해서 머신 리더블 문서가 나오도록 추진하고 있는데, 아직은 영 시원찮은 느낌이다. 그래서 적어도 앞으로 새로 만드는 문서는 처음부터 머신 리더블하게 만들려고 한다.

내가 정리한 새 문서 원칙은 이렇다.

  1. 제목은 '제목 스타일'로: 글자만 크게 키우지 말고 제목 1·2·3 스타일을 쓴다. 그래야 기계가 문서 계층을 안다.
  2. 표는 단순하게: 셀 병합을 최소화하고, 한 칸에 값 하나만 넣는다.
  3. 글자를 그림으로 넣지 않는다: 캡처한 표나 도표 대신 실제 표와 원본 데이터를 함께 둔다.
  4. 저장은 HWPX·DOCX로: 최소한 XML 기반 형식으로 저장하고, 가능하면 마크다운본도 함께 만든다.
  5. 문서 정보를 적는다: 작성일, 작성 부서, 버전, 출처를 문서 첫머리에 넣는다. 날짜는 2026-10-18처럼 한 형식으로 쓴다.

정리하면 머신 리더블은 "AI가 내 문서를 제대로 읽게 하는 최소 조건"이다.

RAG의 답변 품질은 모델보다 먼저 문서에서 결정되더라..

다음 편에서는 그 위층인 AI-Ready 데이터를 행정안전부 가이드라인의 5개 영역(포맷·구조, 데이터 정보 제공, 품질지표, 표준코드, 관리체계) 중심으로 더 자세히 정리해 보겠다.

이상 머신 리더블 문서 정리 끝!

2026년 10월 기준. 참고: W3C 5 Star Linked Data, 행정안전부 보도자료(2026.4.27), 「공공데이터의 인공지능 친화적 관리 가이드라인 V1.0」(행정안전부·NIA, 2026.3), TTA 정보통신용어사전. 문서 단계 구분(0~5단계)은 이해를 돕기 위해 직접 정리한 것이다.

댓글

이 블로그의 인기 게시물

싱가포르 여행 필수 준비물: G타입 변환 어댑터 (돼지코 전기 플러그)

조만간 우리 아이들이 싱가포르로 여행을 간다. 핸드폰 충전은 물론이고 다른 전기 제품 사용 때문에 어댑터가 꼭 필요하다. 해외여행 갈 때 어댑터 하나 잘못 챙겨가면 충전도 못 하고 전기 사용도 못 해서 낭패 보는 경우가 많다. 10년 전에 내가 싱가포르에 출장 갈 일이 있었는데 그때는 멀티 어댑터를 누군가에게 빌려갔었다. 이번 기회에 아이들 여행 준비물 중에 하나인 변환 플러그 검색하면서 알게 된 싱가포르 사용하는 전압과 플러그 타입, 어떤 어댑터를 챙겨야 하는지를 공유하려 한다. 싱가포르 여행을 계획하는 사람들을게 도움이 되겠지?  내 자식들 챙겨주는 마음으로 꼼꼼하게 설명해 줄 테니, 싱가포르 여행 준비물 리스트에 어댑터 관련 정보가 필요한 사람들은 꼭 참고했으면 한다. 1. 싱가포르 전기 환경 (전압과 플러그 타입) 해외여행 시 현지 전기 환경을 파악하는 것은 필수적인 여행 준비물 점검 사항이다. 싱가포르는 한국과 다른 전압 및 플러그 타입을 사용한다. 1.1 싱가포르 전압 (Voltage) 싱가포르는 230V(볼트) 전압을 사용한다. 한국은 220V를 사용하므로 전압 자체는 큰 차이가 없다. 대부분의 최신 전자기기(휴대폰 충전기, 노트북 충전기 등)는 100~240V의 프리볼트(Free Voltage)를 지원하므로, 전압 변환기(변압기)는 별도로 필요하지 않다. 1.2 싱가포르 플러그 타입 (Plug Type) 및 사용 국가 싱가포르는 Type G 플러그를 사용한다. 이는 영국식 3핀(세 발) 플러그 형태로, 한국(Type C, F)과는 모양이 완전히 다르다. 따라서 한국에서 사용하는 전자기기를 싱가포르에서 사용하려면 반드시 Type G 형태의 어댑터가 필요하다. Type G 플러그를 사용하는 주요 국가   아시아: 싱가포르, 홍콩, 말레이시아, 아랍에미리트(UAE) 등 유럽: 영국, 아일랜드, 몰타, 키프로스 등 기타: 사우디아라비아, 카리브해 일부 국가 등 이러한 국가들을 여행할 때도 Type G 어댑터 하나만 있으면 전기 ...

제주도 탐나는전 결제 사용 후기 (실물카드 미소지로 사용 실패)

제주도 여행을 앞두고 지역화폐인 '탐나는전'을 신청했다. 평소 성남사랑상품권을 잘 쓰고 있어서 제주도에서도 비슷하게 편리하게 쓸 수 있을 거라 생각했거든. 그런데... 결론부터 말하면 한 번도 써보지 못하고 환불하게 됐다. 탐나는전 신청과 설정 제주 출발 전에 미리 탐나는전을 신청했어. 신청 후 1주일 이내에 집에 도착.. 안내 브로셔를 보니 꽤 체계적으로 되어있더라고. 캐시백 혜택부터 시작해서 카드 등록, 사용법까지 자세히 나와있었어. 특히 소득공제 혜택도 있고, 한도상향 완료라는 문구도 보이니 더욱 기대가 됐어. 성남사랑상품권처럼 잘 활용할 수 있을 거라 생각했거든. 카드 등록 카드 등록을 진행했어. 인터페이스도 깔끔하고 사용하기 편해 보였어. "탐나는전 사용 가능한 카드를 신청 또는 등록해주세요!"라는 안내 문구를 보며 설레었지. 카드 정보를 직접 입력하거나 바코드로 인식할 수 있게 되어있어서 편리했어. 성남사랑상품권 앱과 비슷한 느낌이었거든. 난 바코드로 한큐에 등록.. 출발 전날인 6월 24일에 10만원을 충전했어. 탐나는전 선불카드로 등록도 완료하고, 제주도에서 맛있는 것도 사고 기념품도 살 생각에 들떠있었지. 그런데... 현실은? 제주도에 도착해서 탐나는전을 써보려고 했는데, 큰 문제가 있었어. 성남사랑상품권처럼 QR코드나 바코드로 간편하게 결제할 수 있을 거라 생각하고 실물카드를 안 가져갔거든. 그런데 제주도 매장들은 대부분 실물카드만 받더라고! QR코드나 바코드 결제를 지원하는 곳이 거의 없어서 당황했어. 성남에서는 거의 모든 곳에서 앱으로 간편결제가 되니까 당연히 제주도에서도 될 거라 생각했는데... 완전 오산이었어 😢 결국 환불... 여행 내내 한 번도 써보지 못하고, 마지막 날인 6월 29일에 결국 10만원 전액 환불했어. 충전 수수료나 환불 수수료 같은 건 없어서 다행이었지만, 뭔가 허무한 기분이었어. 후기와 조언 탐나는전 자체는 나쁘지 않은 시스템인 것 같아. 소득공제 혜택도 있고, 앱도 사용하기 편해...

미국 주식 투자 환전 수수료 비교 (증권사 환율우대 100% 찾는 법)

나는 달러 환테크와 미국 주식 투자를 병행하고 있다. 단순히 달러를 사고파는 것을 넘어, 환전한 달러로 바로 미국 주식을 매매할 수 있어야 하므로 증권사 환전 서비스를 이용하는 것은 필수다. 혹시 미국 주식을 아직도 한번도 매매 못한 사람을 위해 일반적인 프로세스는 아래와 같다. 이때 가장 중요한 것이 바로 '환전수수료' , 즉 환율우대 혜택이다. 1%, 0.1%의 수수료 차이가 투자 수익률에 큰 영향을 미치기 때문이다. 오늘은 미국 주식 투자를 위한 증권사별 환전 서비스를  비교하고, 환율우대 혜택을 가장 많이 받을 수 있는 곳이 어디인지 직접 정리해 본다.  1. 들어가기 전: 환전수수료와 환율우대란? 우리가 달러를 살 때, 기준이 되는 '매매기준율'에 증권사가 수수료를 붙여서 판매한다. 이 수수료를 '환전 스프레드' 라고 하며, 보통 1달러당 5원~10원 정도다. '환율우대' 란 이 환전 스프레드를 깎아주는 것을 의미한다. 예를 들어, 환율우대 95% 는 내가 내야 할 환전수수료의 95%를 할인해준다는 뜻이다. 당연히 우대율이 높을수록 우리에게 유리하며, 환율우대 100%는 환전수수료가 0원 이라는 의미다. 2. 증권사별 환전 우대율 및 이용 시간 비교 (우대율 높은 순) ※ 중요: 아래 정보는 신규 또는 휴면 고객 대상 이벤트 기준으로, 2025년 8월 말 현재 시점으로 재확인한 내용이다. 이벤트 기간이나 조건은 언제든 변경될 수 있으니, 거래 전 반드시 해당 증권사에 직접 확인해야 한다. 참고로 난 한투로 미국 주식을 하고 있는데 90% 우대를 받고 있다. 아직은 작은 금액이라 무시하고 있지만 억단위로 넘어가면 위 증권사 계좌로 넘어갈 계획이다. 3. 서비스별 심층 분석 및 투자 전략 3.1 조건부 최강자: NH투자증권 (나무증권)  NH투자증권은 '원화주문' 이라는 독특한 서비스를 통해 차별점을 가진다. 핵심 장점: 24시간 100% 자동 환율우대: 미국 주식 시장이 열리...