개발자들의 표준 문서 포맷은 당연히 Mark Down이다.
대부분의 위키 그리고, git hub, confluence도 mark down 문법을 지원하면서 문서 그 자체로 버전 관리할 수 있게 되었다.
나 또한 Mark Down 를 만들 때 VS Code 아니면 Typora를 사용한다.
이렇게 만든 Mark Down을 Presentation을 할 때도 marp라는 툴을 사용하면 간단히 파일 변환을 하여 발표할 수 있다.
Marp 툴 공식 사이트는 https://marp.app/
먼저 marp-cli 부터 설치해 보자.
❯ npm install -g @marp-team/marp-cli
C:\Users\sungy\AppData\Roaming\npm\marp -> C:\Users\sungy\AppData\Roaming\npm\node_modules\@marp-team\marp-cli\marp-cli.js
npm WARN optional SKIPPING OPTIONAL DEPENDENCY: fsevents@~2.1.2 (node_modules\@marp-team\marp-cli\node_modules\chokidar\node_modules\fsevents):
npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for fsevents@2.1.3: wanted {"os":"darwin","arch":"any"} (current: {"os":"win32","arch":"x64"})+ @marp-team/marp-cli@0.21.1
added 264 packages from 536 contributors in 55.662s
설치가 끝났으면 버전 확인. 현재 난 0.21.1을 쓰고 있다.
> marp --version
@marp-team/marp-cli v0.21.1 (w/ @marp-team/marp-core v1.3.0)Mark Down 파일은 기본적으로 html, pdf, pptx로 변환을 지원한다.
사용법은 간단하다.
아무 옵션 없으면 html, — pdf 를 주면 pdf 로, — pptx로 주면 pptx로, — image로 주면 image 파일로 변환된다.
아래처럼 하면 slid-deck.pdf 파일이 생성된다.
marp --pdf slide-deck.md일반 Mark down을 그냥 변환하면, 페이지 구분, 배경 설정이 없으므로 이를 위한 확장 Mark Down 문법을 써야 한다. 자세한 내용은 https://marpit.marp.app/markdown
내가 주로 쓰는 것은
- 테마
---theme: gaia_class: leadpaginate: truebackgroundColor: #fffmarp: truebackgroundImage: url('https://marp.app/assets/hero-background.jpg')---
- 페이지 구분
---- 줄 바꿈
\- 공백 문자 채우기
$~~~~~~~~~~~~$내가 가진 md 파일 중 발표용으로 만든 md를 ppt로 변환해 본다.
❯ marp --pptx '.\Enterprise Architect로 UML 모델링.md'
[ INFO ] Converting 1 markdown...
[ WARN ] Marp CLI has detected accessing to local file. That is blocked by security reason. Instead we recommend using
assets uploaded to online. (Or you can use --allow-local-files option if you are understood of security risk)
[ INFO ] Enterprise Architect로 UML 모델링.md => Enterprise Architect로 UML 모델링.pptx생성된 pptx 파일을 여러 보면 그다지 세련되지는 않아도 담백한 PPT 장표가 생성되었다.
