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

게시 2026-09-29실측 기준 2026-09-28읽는 시간 약 2분elta · EltaCrew

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

왜 기호만 보일까

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

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

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

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

뷰어를 고를 때 확인할 것

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

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

정리

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

Android마크다운생산성MdViewer

함께 읽기

로또 용지 QR 인식 성공이 0건이었던 이유: 기록하지 않은 경로는 실패처럼 보인다로또 앱 주간 보고에서 QR 화면을 연 사람은 19명인데 인식 성공은 0건이었습니다. 스캐너가 고장 난 게 아니라, 진짜 용지 QR 이 지나가는 경로에 기록이 하나도 없었습니다. 측정 구멍을 찾은 과정, 같은 기능 앱 4개와 비교한 결과, 스캔 엔진을 번들로 바꾼 이유, 고친 뒤 1주일 숫자를 정리합니다.지도 왼쪽 아래 로고를 누르면 앱이 꺼졌다: 네이버 지도 SDK 와 AppCompat 테마로또 판매점 지도 앱의 Crashlytics 에 「You need to use a Theme.AppCompat theme」 크래시가 4건 올라왔습니다. 사용자가 아니라 Play 사전 출시 보고서의 테스트 로봇이 지도 왼쪽 아래 NAVER 로고를 누른 것이었습니다. 원인, 앱 전체 테마를 바꾸지 않고 지도만 감싼 수정, 다크 모드에서 생긴 두 번째 문제를 정리합니다.광고 SDK 초기화가 끝나기 전에 광고를 요청하면 꺼진다: 막는 장치를 만들고도 세 번 다시 나온 이유운영 중인 앱에서 「MobileAds.initialize must be called」 크래시를 처음 고친 뒤에도 같은 크래시가 다른 모양으로 세 번 더 나왔습니다. 초기화 완료를 기다리는 장치는 있었지만, 시작 시점에 켜지는 값, 동의만 보고 켜지는 값, 그 장치를 거치지 않는 새 광고 자리가 빈틈이었습니다. 각 경우의 원인과 23개 앱 전수 점검 결과를 정리합니다.