안드로이드에서 .md 파일 여는 법: AI 가 준 마크다운이 기호 범벅으로 보일 때

ChatGPT·Claude·Codex 가 만들어 준 .md 파일, 옵시디언 노트, 깃허브 README 를 폰에서 열면 #·*·| 가 그대로 보입니다. 마크다운을 폰에서 제대로 읽는 방법과, 표·체크리스트·수식이 깨지는 이유, 직접 뷰어를 만들며 확인한 점을 씁니다.

왜 기호만 보일까

마크다운(.md)은 서식이 아니라 서식을 지시하는 글자로 저장됩니다. # 제목 은 「이 줄은 제목」, - [ ] 는 「체크박스」, | a | b | 는 「표 한 줄」이라는 뜻입니다. 이 글자를 해석해서 그려 주는 프로그램(렌더러)이 있어야 제목·표·체크리스트로 보입니다.

PC 에서는 VS Code·옵시디언·깃허브가 이 일을 해 줍니다. 폰에서는 파일을 눌렀을 때 텍스트 편집기로 열리는 경우가 많고, 그러면 지시 글자가 그대로 보입니다. 요즘 이 문제가 부쩍 잦아진 건 AI 도구 때문입니다. CLAUDE.md·AGENTS.md 같은 설정 파일, 「이 대화를 정리해서 .md 로 줘」 로 받은 요약 파일이 전부 마크다운입니다.

폰에서 제대로 보는 방법 3가지

1. 깃허브 앱·웹에서 보기 — 저장소에 있는 README 라면 가장 간단합니다. 단, 저장소에 올라가 있지 않은 파일(메일·메신저로 받은 파일)은 안 됩니다.
2. 노트 앱으로 가져오기 — 옵시디언 모바일 같은 노트 앱에 볼트를 만들고 파일을 넣으면 보입니다. 파일 하나 잠깐 보려고 볼트를 만드는 건 번거롭습니다.
3. 마크다운 뷰어 앱으로 바로 열기 — 파일을 누르거나 앱에서 「파일 열기」로 고르면 바로 렌더링해서 보여 줍니다. 파일 하나를 빨리 확인하는 데는 이 방법이 가장 짧습니다.

뷰어를 고를 때 확인할 것

직접 안드로이드 마크다운 뷰어(MdViewer)를 만들면서, 실제 파일에서 자주 깨지는 부분을 정리하면 이렇습니다.

• 표 — AI 가 만든 문서에는 표가 많습니다. 칸이 많으면 화면 폭을 넘는데, 가로 스크롤이 안 되면 글자가 뭉개집니다.
• 체크리스트 — - [ ] / - [x] 를 체크박스로 그려 주는지.
• 코드 블록 — 코드가 줄바꿈되지 않고 가로로 스크롤되는지, 언어별 색이 있는지.
• 수식 — $…$, $$…$$ 로 쓴 수식(LaTeX)을 그려 주는지. 논문 정리·수업 노트에 자주 나옵니다.
• 큰 파일 — 수십만 자짜리 로그·정리 문서를 열 때 멈추지 않는지. MdViewer 는 70만 자 문서의 첫 화면이 약 0.7초에 뜨도록 보는 화면을 바꿨습니다(2026-09-25 측정).
• 편집·내보내기 — 한 줄 고치거나, 다른 사람에게 보낼 때 PDF 로 내보낼 수 있는지. PDF 로 보내면 받는 사람 쪽에서 서식이 깨지지 않습니다.

정리

• .md 가 기호로 보이는 건 파일이 깨진 게 아니라, 그려 주는 프로그램이 없어서입니다.
• 저장소 파일은 깃허브, 노트로 쌓을 파일은 노트 앱, 받은 파일을 바로 볼 때는 뷰어 앱이 가장 짧습니다.
• 제가 만든 MdViewer(Google Play) 는 표·체크리스트·코드·수식을 그려 주고, 편집·분할 미리보기·PDF 내보내기를 지원합니다.