DEVOCEAN

개발자에게 문서화는 귀찮으면서도 뗄레야 뗄수없는 커뮤니케이션의 하나의 수단이기도 합니다.

그런 개발자에게 익숙한 포맷은 아무래도 마크다운(Markdown)일겁니다. github의 README를 포함하여 노션, 슬랙 등에서도 지원하는 포맷이기도 하죠.

하지만 발표자료를 만들어야할 때 가장 먼저 떠오르는건 역시 파워포인트(ppt)나 pdf를 떠올리게 될텐데요.

부득이하게 Markdown으로 만든 자료를 구글 독스나 MS 파워포인트 등의 툴을 이용하여 재작성하는 경우가 많습니다.

혹시나 Markdown 을 활발하게 작성하는 개발자라면 이걸로 어떻게 발표자료 못 만드나 싶은 생각을 한번쯤 해보셨을텐데

MARP 가 그에 대한 하나의 대안이 될 수 있습니다.

Installation

VSCode Extentsion으로도 제공하는 MARP는 npm 으로 설치할 수 있는 Marp CLI 와 Visual Studio Code(VS Code) Extension을 제공합니다.

VSCode Extension에서 쉽게 검색해서 설치할 수 있습니다.

설치가 끝났으면 VSCode 에서 markdown 문법으로 간단한 프리젠테이션을 만들어봅시다.

Getting Started

다음은 MARP 홈페이지에 올라온 프리젠테이션 예시입니다.

MARP 에서 Markdown을 변환 가능한 포맷인지 인지하기 위해 Markdown의 맨 위는 항상 다음과 같이 시작해야 합니다.

---
marp: true
---

여기서 전체적인 프리젠테이션의 테마와 같은 여러 세팅을 설정해서 쓸 수 있습니다.

위에 보이는 그림은 MARP 홈페이지에 나온 예제 프리젠테이션입니다.

하기와 같은 Markdown 포맷으로 문서를 만들고 VSCode 에서 Export Slide deck 을 통해 다양한 포맷으로 변환할 수 있습니다.

문서는 다음과 같이 Markdown 문법으로 작성합니다.

---
theme: gaia
_class: lead
paginate: true
backgroundColor: #fff
backgroundImage: url('https://marp.app/assets/hero-background.svg')
---

![bg left:40% 80%](https://marp.app/assets/marp.svg)

# **Marp**

Markdown Presentation Ecosystem

https://marp.app/

---

# How to write slides

Split pages by horizontal ruler (`---`). It's very simple! :satisfied:

```markdown
# Slide 1

foobar

---

# Slide 2

foobar

Review

MARP 의 한계점은 아직 테마가 전문 툴만큼 많지 않고 세부적인 요소들의 사이즈 조절 및 위치 조정 등이 지원되지 않거나 불편한 점이 있습니다만,

전문적인 자료 작성이 아닌 팀 내부 세미나 용도나 개인적인 문서 작성 용도로는 Markdown 문서를 재활용하여 빠르게 프리젠테이션 준비를 할 수 있다는게 장점으로 보입니다.

Reference

• MARP: Official website

• MARP: Github

• MARP - 마크다운(.md) 문서로 PPT / PDF를 만들어 보자

• [Marp] Markdown으로 프레젠테이션 만들기 / Marp for VS Code