누군가가 보낸 파일을 열었는데 끝이 .md로 끝나면 잠깐 멈칫하게 된다. 특히 구글 Stitch 같은 AI UI 도구가 결과물로 이런 파일을 내보냈다면 더 낯설다. Word 문서도 아니고 PDF도 아닌데, 이용자는 어떤 앱으로 열어야 할지부터 고민하게 된다.
MD 파일은 특정 회사의 전용 문서가 아니다. Markdown이라는 텍스트 형식으로 만든 파일이며, 안에는 사람이 읽을 수 있는 글이 들어 있다. 확장자만 낯설 뿐 기본 구조는 제목, 목록, 링크, 코드 설명 같은 텍스트다.
먼저 열어 보는 방법
가장 쉬운 방법은 메모장이나 TextEdit로 여는 것이다. Windows라면 파일을 우클릭해 메모장을 고르면 되고, Mac에서는 TextEdit로 열면 된다. 이렇게 열면 서식은 투박하게 보일 수 있지만 내용 자체는 확인된다.
조금 더 보기 좋게 읽고 싶다면 VS Code, Obsidian, Typora 같은 앱을 쓰면 된다. VS Code는 Markdown 파일을 편집하고 미리보기로 확인하는 기능을 제공한다. 같은 파일이라도 일반 텍스트 화면과 서식이 적용된 미리보기 화면을 오가며 읽을 수 있다.
안에 보이는 기호는 서식 표시다
MD 파일을 처음 열면 #, -, [], () 같은 기호가 눈에 먼저 들어온다. 이것들은 깨진 문자가 아니라 서식 표시다. #은 제목, -는 목록, [텍스트](주소)는 링크를 뜻한다. 개발 문서처럼 보여도 실제로는 글의 구조를 표시하는 약속에 가깝다.
이 형식의 장점은 앱을 잘못 골라도 내용이 쉽게 망가지지 않는다는 데 있다. 메모장으로 열면 평범한 글처럼 읽고, Markdown을 지원하는 앱으로 열면 제목과 목록이 정리된 문서처럼 보인다. 블로그 초안, 회의록, 개발 문서, AI 프롬프트, 제품 기획 메모를 주고받을 때 자주 쓰이는 이유다.
구글 Stitch 결과물에서 MD 파일이 나오는 이유
구글 Stitch 같은 UI 생성 도구에서 MD 파일을 받았다면, 그 파일을 최종 앱 화면으로 보면 안 된다. 보통은 화면 구조, 의도, 컴포넌트 설명, 작업 지시가 담긴 설계 메모에 가깝다. 이용자는 예쁜 문서 하나가 아니라 다음 작업자가 이해할 설명서를 받은 셈이다.
AI 도구가 Markdown을 쓰는 이유도 여기에 있다. Word처럼 꾸며진 문서보다 사람이 읽기 쉽고, AI나 개발 도구가 다시 해석하기 쉬운 텍스트가 필요할 때 Markdown이 잘 맞는다. 복사해서 다른 도구에 붙여 넣기도 쉽고, GitHub나 개발 환경에서도 다루기 편하다.
더블클릭해도 안 열릴 때
파일을 더블클릭했는데 아무 일도 일어나지 않거나 알 수 없는 파일이라고 나온다면 파일이 망가졌다고 단정할 필요는 없다. 대부분은 운영체제에 연결 앱이 지정되지 않은 상황이다. 우클릭 후 열기 방식으로 메모장, TextEdit, VS Code 중 하나를 직접 선택하면 된다.
Word로 열 수도 있지만 기대한 서식으로 보이지 않을 수 있다. 제출용 문서라면 Markdown 파일을 그대로 보내기보다 PDF나 Word로 변환하는 편이 낫다. 반대로 개발자나 AI 도구에 다시 넘길 자료라면 원본 MD를 유지하는 쪽이 더 안전하다. 중간에 Word로 옮기면서 기호나 줄바꿈이 바뀌면 원래 의도가 흐려질 수 있다.
어떤 선택이 맞나
내용만 확인하려면 메모장으로 충분하다. 읽기 편한 화면이 필요하면 VS Code나 Obsidian을 고르면 된다. 블로그나 보고서에 붙여 넣을 목적이라면 필요한 부분만 복사하거나 PDF·Word로 변환하면 된다.
구글 Stitch가 만든 MD 파일도 같은 기준으로 보면 된다. 화면을 바로 실행하는 파일이 아니라, 화면을 만들기 전의 설명 문서에 가깝다. 그래서 먼저 열어 읽고, 그다음에 그대로 전달할지 변환할지 정하면 된다.
참고 URL
- https://www.markdownguide.org/getting-started/
- Markdown의 기본 개념과 일반 텍스트 서식 방식을 볼 수 있다.
- https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax
- 제목, 목록, 링크, 코드 블록 같은 기본 Markdown 문법이 정리돼 있다.
- https://code.visualstudio.com/docs/languages/markdown
- VS Code에서 Markdown 파일을 편집하고 미리보기로 읽는 방법을 볼 수 있다.
- https://stitch.withgoogle.com/
- Google Stitch가 UI 아이디어를 디자인과 코드 결과물로 연결하는 방식을 확인할 수 있다.
관련 글
같은 맥락에서 이어서 읽기 좋은 글들입니다.