AI 시대, 마크다운 포맷의 중요성과 활용가이드 📚

LLM이 읽기 좋은 문서를 작성하는 법
Agent Pro's avatar
Jul 03, 2025
AI 시대, 마크다운 포맷의 중요성과 활용가이드 📚
💡
AI와 효율적으로 소통할 수 있는 표현 방법, 마크다운의 개념과 실행 가이드를 설명합니다.
 
이제 많은 일상 업무에서 AI와 소통하며, 도움을 받고 협업하는 시대이다. 이때 우리에게 필요한 것이 바로 AI와 원활하게 소통하는 기술이 프롬프트 엔지니어링이며, 프롬프트에 사용되는 대표적인 표현방식이 바로 마크다운(Markdown)이다.
이처럼 마크다운은 단순한 '개발자 도구'가 아니라, AI와 명확하게 소통하여 원하는 결과물을 정확히 얻어내는 '핵심 소통 기술'이다. 이번 글에서는 마크다운의 개념부터, AI 활용도를 극대화하는 프롬프트 작성법까지 정리해보았다

📝마크다운이란?

마크다운(Markdown)은 2004년 존 그루버와 아론 스워츠가 개발한 경량 마크업 언어이다. 일반 텍스트에 간단한 기호를 사용하여 서식을 지정하는 방식으로, HTML처럼 복잡한 태그 없이도 구조화된 문서를 만들 수 있다.
  • 예를들면 ** ** 기호는 글자를 굵게(bold) 표현하는 방법이다.
    • **굵게** 라고 입력하면, 글자가 굵게 출력된다.
 
마크다운 규칙 예시
출처: coursera
출처: coursera
이처럼 마크다운은 배우기 쉽고 직관적이어서, 개발자가 아니더라도 비교적 쉽게 사용할 수 있다.

🤖 마크다운이 LLM 활용에 중요한 이유

안드레 카파시(전 테슬라 AI 책임자)는 현재를 "소프트웨어 3.0 시대"라고 정의했다.
Andrej Karpathy: Software Is Changing (Again)
Andrej Karpathy's keynote on June 17, 2025 at AI Startup School in San Francisco. Slides provided by Andrej: https://drive.google.com/file/d/1a0h1mkwfmV2PlekxDN8isMrDA5evc4wW/view?usp=sharing Chapters (Powered by https://ChapterMe.co) - 00:00 - Intro 01:25 - Software evolution: From 1.0 to 3.0 04:40 - Programming in English: Rise of Software 3.0 06:10 - LLMs as utilities, fabs, and operating systems 11:04 - The new LLM OS and historical computing analogies 14:39 - Psychology of LLMs: People spirits and cognitive quirks 18:22 - Designing LLM apps with partial autonomy 23:40 - The importance of human-AI collaboration loops 26:00 - Lessons from Tesla Autopilot & autonomy sliders 27:52 - The Iron Man analogy: Augmentation vs. agents 29:06 - Vibe Coding: Everyone is now a programmer 33:39 - Building for agents: Future-ready digital infrastructure 38:14 - Summary: We’re in the 1960s of LLMs — time to build Drawing on his work at Stanford, OpenAI, and Tesla, Andrej sees a shift underway. Software is changing, again. We’ve entered the era of “Software 3.0,” where natural language becomes the new programming interface and models do the rest. He explores what this shift means for developers, users, and the design of software itself— that we're not just using new tools, but building a new kind of computer. More content from Andrej: https://www.youtube.com/@AndrejKarpathy Thoughts (From Andrej Karpathy!) 0:49 - Imo fair to say that software is changing quite fundamentally again. LLMs are a new kind of computer, and you program them *in English*. Hence I think they are well deserving of a major version upgrade in terms of software. 6:06 - LLMs have properties of utilities, of fabs, and of operating systems → New LLM OS, fabbed by labs, and distributed like utilities (for now). Many historical analogies apply - imo we are computing circa ~1960s. 14:39 - LLM psychology: LLMs = "people spirits", stochastic simulations of people, where the simulator is an autoregressive Transformer. Since they are trained on human data, they have a kind of emergent psychology, and are simultaneously superhuman in some ways, but also fallible in many others. Given this, how do we productively work with them hand in hand? Switching gears to opportunities... 18:16 - LLMs are "people spirits" → can build partially autonomous products. 29:05 - LLMs are programmed in English → make software highly accessible! (yes, vibe coding) 33:36 - LLMs are new primary consumer/manipulator of digital information (adding to GUIs/humans and APIs/programs) → Build for agents! Some of the links: - Software 2.0 blog post from 2017 https://karpathy.medium.com/software-2-0-a64152b37c35 - How LLMs flip the script on technology diffusion https://karpathy.bearblog.dev/power-to-the-people/ - Vibe coding MenuGen (retrospective) https://karpathy.bearblog.dev/vibe-coding-menugen/
Andrej Karpathy: Software Is Changing (Again)
  • 1.0 시대는 사람이 읽기 좋은 언어를 쓴다 = GUI
  • 2.0 시대는 컴퓨터가 읽기 좋은 언어를 쓴다 = API
  • 3.0 시대는 “사람 같은 컴퓨터(=AI)”가 읽기 좋은 언어를 쓴다 = LLM/Agent
 
예를들어, 감정을 분석해서 분류하는 프로그래밍을 할 때 각각의 코드 예시는 아래와 같다. Software 3.0은 프롬프트=프로그래밍 언어가 되었고, 마크다운은 LLM이 프롬프트나 문서를 읽을 때 편한 문법이다.
나아가 이제는 웹페이지도 LLM이 읽기 좋도록, .md나 llms.txt를 제공해야하는 시대이다.
  • 최근에 주요 AI 서비스들이 웹사이트를 크롤링 할 때, llms.txt를 참조하기 시작했다는 이야기도 있다(참고)
 

🎯 LLM에 마크다운 포맷을 쓰면 좋은 점

 
효율: 비용과 속도
  • 마크다운은 동일한 정보를 더 적은 토큰으로 표현하여, 비용 절약처리 속도 향상을 동시에 제공한다.
🌐 범용성
  • GitHub, 노션, 디스코드 등 어디서나 동일한 규칙으로 사용 가능하다.
  • RAG 시스템에서 PDF나 복잡한 문서를 텍스트로 변환할 때, 마크다운은 원본의 계층 구조의미적 관계를 그대로 유지한다.
🔄 LLM이 잘 학습한 데이터
  • GPT-4, Claude 등 최신 LLM들은 GitHub의 마크다운 문서를 대량 학습했기 때문에, 마크다운을 '모국어'처럼 잘 이해한다.
📕가독성 향상
  • #으로 제목, *로 목록을 만드는 등 직관적인 문법을 사용한다.
  • 구조화된 마크다운 프롬프트는 사용자와 AI 모두에게 명확한 의도 전달을 가능하게 한다.
 

🛠️ 마크다운 작성을 위한 문서 도구

마크다운 글쓰기 도구

 
📚 노션
노션은 네이티브 마크다운 지원이 되는 가장 대표적인 문서 작성 도구이다. 다음과 같은 방식으로 마크다운을 활용할 수 있다.
  • 실시간 변환: 마크다운 문법을 입력하면 즉시 서식 적용
    • 예를 들어, # + 스페이스바를 입력하면 자동으로 Headline 1의 포맷으로 변환이 된다.
  • Import/Export: .md 파일을 직접 가져오기/내보내기 지원
  • 단축키 지원: / 명령어와 마크다운 문법 병행 사용 가능
 
📄 구글 독스
  • 사용법: 도구 → 환경설정 → "마크다운 사용" 체크하면 된다.
  • 기능:
    • 노션과 마찬가지로 마크다운 형식을 인식한다.
    • 마크다운으로 작성한 내용을 붙여넣으면 자동 포맷팅이 된다.
    • .md 파일 직접 가져오거나 .md 포맷으로 저장하기
 
🔍 AI 글쓰기 도구(GPT, Claude, Genspark, etc)
  • LLM 도구들은 대부분 마크다운 입력/출력을 지원한다.
    • 내보내기를 해보면 .md 형식 옵션을 확인할 수 있다.
      • GPT 화면 예시
        GPT 화면 예시
    • Canvas 등 문서/코드 편집 도구에서 “마크다운 포맷”을 요구하면 애써서 작성해준다.
  • 다운로드 받거나, 복사 붙여넣기를 통해 생성된 콘텐츠를 바로 옮길 수 있다.
  • 참고로 젠스파크는 25년 7월 3일에 [AI 문서] 기능이 새로 나왔다. 마크다운 포맷을 처음부터 선택해서 작성할 수 있다.
    • notion image
 
 

3-2. 전문 마크다운 에디터/변환기

 
🏆 Typora
  • 가격: $19.99 (일회성 라이선스)
  • 특징: WYSIWYG 실시간 미리보기
  • 장점:
    • 가장 직관적인 사용자 경험
    • 수학 수식, 다이어그램 지원
    • 깔끔하고 집중하기 좋은 인터페이스
 
🆓옵시디언(https://obsidian.md/)
개인 지식관리를 위해 숨은 고수분들이 쓰고 있는 혁신적인 도구
  • 가격: 개인용 무료, 동기화는 $4.99/월
  • 특징
    • 100% 로컬환경 사용 가능, 마크다운 포맷 사용
    • 백링크와 그래프 뷰로 아이디어 연결
    • 풍부한 플러그인 생태계
 
⚡ 기타: Microsoft의 Markitdown(링크)
  • PDT, PPT, HTML, 유튜브 링크 등 다양한 파일을 마크다운(Markdown) 형식으로 변환해주는 가벼운 파이썬(Python) 도구
 

🎯 마크다운 포맷으로 프롬프트 작성 예시

기본 프롬프트

건강한 식단을 만들어줘. 나는 채식주의자고 40세 여성이야. 칼로리는 1500-1800 정도로 하고 단백질 탄수화물 지방 균형잡힌 걸로 해줘. 아침 점심 저녁으로 나눠주고 간식도 넣어줘.

마크다운 프롬프트

 
🥕 예시: 건강한 식단 계획짜기 프롬프트
# 건강한 식단 계획 작성 요청 ## 개인 정보 - **나이**: 40세 - **성별**: 여성 - **식습관**: 채식주의자 - **목표**: 건강한 식습관 형성 ## 식단 요구사항 1. **일일 칼로리**: 1,500~1,800 kcal 2. **영양 균형**: 단백질, 복합 탄수화물, 건강한 지방 3. **식사 구성**: 아침, 점심, 저녁 + 간식 4. **표시 형식**: 음식명과 분량 명시 ## 추가 요청사항 - [ ] 간단한 조리법 위주 - [ ] 주간 운동 계획 포함 - [ ] 실천 가능한 생활 습관 팁 ## 출력 형식 마크다운으로 정리해서 표 형식으로 제공해주세요.
🎨 예시: 마케팅 콘텐츠 제작 프롬프트
# 블로그 콘텐츠 제작 가이드 ## 타겟 오디언스 > AI 도구에 관심 있는 직장인 (25-40세) ### 페르소나 - **직업**: 마케터, 기획자, 개발자 - **고민**: 업무 효율성, 트렌드 적응 - **선호 콘텐츠**: 실용적 가이드, 사례 연구 ## 콘텐츠 요구사항 ### 형식 - **길이**: 2,000-3,000자 - **구조**: 도입-본론-결론-CTA - **톤앤매너**: 친근하면서 전문적 ### 필수 포함 요소 1. 📊 실제 데이터/통계 2. 💡 실무 활용 팁 3. 🔗 관련 도구 링크 4. 📝 체크리스트 ## SEO 최적화 - **키워드**: AI 도구, 업무 자동화, 생산성 - **메타 설명**: 120자 이내 - **내부 링크**: 3-5개 포함
 
마크다운 프롬프트 예시를 보면 단순히 '요청'하는 것을 넘어, AI에게 명확한 '설계도'를 제시한다. 마크다운을 통해 역할, 맥락, 과업, 결과물 형식을 구조적으로 전달함으로써 AI가 길을 잃지 않도록 안내하는 것이다. 마크다운을 활용한 명확한 소통은 AI가 사용자의 의도를 훨씬 정확하게 파악하고, 만족스러운 결과물을 생성할 확률을 높인다.

🚀 마치며: 지금부터 적용!

마크다운은 단순한 문서 작성 도구를 넘어 AI 시대의 핵심적인 소통 방식이 되었다. 마크다운은 그 소통을 도와주는 강력하고 효율적인 도구이다. AI를 활용하고 나아가 협업 해야 하는 시대, 이제 인간은 “인간 같은 컴퓨터”인 LLM이 “읽기 좋은” 문서를 작성해야한다.
  • 항상 LLM이 읽기 좋도록 마크다운 형식으로 문서를 작성하고 유지하자.
  • 문서 작성 도구가 마크다운 포맷을 지원하는지, .md 포맷으로 출력 가능한지도 확인하자.
지금부터 AI와 대화하거나 문서를 작성할 때, 마크다운으로 작성해보는 것은 어떨까? 예를 들어, '# 요청: 주간 업무 보고서 초안 작성' 처럼 제목만이라도 #을 붙여 시작해보자!
 

📚 참고 자료

 
Share article
세미나/워크샵/컨설팅 문의사항은 이메일을 남겨주세요.

ProAgent AI