---
url: "/ko/pitchdeck/faq/troubleshooting.md"
description: "Pitchdeck 내보내기, 임베드, 자주 발생하는 프레젠테이션 문제를 해결하는 가이드예요."
---

# Pitchdeck 문제 해결

> Pitchdeck 내보내기, 임베드, 자주 발생하는 프레젠테이션 문제를 해결하는 가이드예요.

## Figma에서 PDF로 내보낼 때 레이어가 사라지고 보라색 사각형으로 바뀌는 문제

이미지 대신 보라색 상자가 표시될 수 있는 알려진 [Figma 버그](https://forum.figma.com/t/pdf-export-consistently-missing-elements/3547)예요. Pitchdeck은 Figma의 기본 PDF 내보내기를 사용하므로 Pitchdeck으로 내보낸 파일에도 같은 문제가 나타날 수 있어요.

문제가 되는 레이어가 실제로 메인 Figma 프레임 _안에_ 들어 있는지 확인하면 도움이 될 수 있어요. 캔버스에서는 레이어가 프레임 위에 “보이게” 놓여 있지만 실제로는 프레임 밖에 있는 경우가 있는데, 이 문제가 가끔 생기는 원인과 관련이 있는 것으로 보여요.

## 한 프레젠테이션에서 서로 다른 프레임이나 슬라이드 크기 사용하기

그래도 한 가지 크기로 통일하는 것을 권장해요. 16:9 프레임이나 기본 Figma Slides(예: **1280x720** 또는 **1920x1080**)를 사용하면 모니터, PowerPoint, Google Slides에서 가장 예측 가능한 결과를 얻을 수 있어요.

PowerPoint 호환 내보내기에 서로 다른 슬라이드 크기가 섞여 있으면, Pitchdeck은 가장 많이 쓰인 크기를 프레젠테이션 크기로 사용하고 크기가 다른 슬라이드는 잘라내지 않고 비율에 맞춰 그 안에 맞춰요. **Use Editable Text**를 켜면 지원되는 텍스트와 도형은 맞춘 크기 그대로 PowerPoint, Keynote, Google Slides에서 편집할 수 있어요. **[PNG]** 를 붙인 레이어처럼 이미지 대체가 필요한 콘텐츠는 이미지로 남아요. 편집 가능한 텍스트를 끄면 크기가 다른 슬라이드는 각각 슬라이드 전체를 하나의 이미지로 내보내요.

## Figma 파일이나 Figma 페이지를 복제하면 URL과 비밀번호도 복제돼요

Figma 파일(또는 Figma 파일 안의 “페이지”)을 “복제”하면 원본의 URL과 비밀번호도 한 번 함께 복사돼요. 그래서 새 URL이 필요하다면 빈 파일이나 페이지를 새로 만드는 것이 가장 좋아요.

이렇게 하면 Figma 파일 안에서 페이지마다 별도의 프레젠테이션 덱을 관리할 수 있어요(아예 별도의 Figma 파일을 사용해도 돼요). 이런 방식으로 프레젠테이션 URL을 개수 제한 없이 만들 수 있어요.

## Google Slides는 ‘사용자 지정’ 폰트로 Google Fonts만 지원해요

Figma에서 서드파티 폰트로 슬라이드를 디자인하고 Google Slides용으로 프레젠테이션을 내보낸다면, Google Slides는 그 폰트를 렌더링할 수 없다는 점에 유의하세요(컴퓨터에 설치되어 있어도 마찬가지예요). Google Slides는 [Google Fonts](https://fonts.google.com/)에서 제공하는 폰트만 지원하기 때문이에요.

## 내보낸 PDF나 PPTX 파일의 다운로드 버튼이 작동하지 않는 문제

플러그인의 내보내기 확인 화면에서 **Download** 버튼을 클릭해도 파일이 다운로드되지 않는다면, Figma 앱을 다시 시작하세요(브라우저 버전을 사용한다면 Figma 탭을 닫았다가 다시 여세요). 그런 다음 플러그인을 다시 실행해 파일을 다시 내보내면 문제가 해결될 거예요.

## 내보내기 중 GIF나 동영상을 불러올 수 없는 문제

PowerPoint 호환 내보내기 중에 외부 GIF나 MP4를 다운로드하거나 디코딩할 수 없으면, Pitchdeck은 해당 레이어의 Figma 아트워크를 정지 이미지로 사용하고 나머지 슬라이드를 계속 내보내요. 내보내기 확인 화면에는 경고와 함께 문제가 된 레이어로 가는 링크가 표시돼요. 정지 이미지는 Figma 아트워크를 그대로 유지하지만, 불러오지 못한 미디어의 애니메이션이나 재생은 포함되지 않아요.

미디어를 복원하려면 해당 URL이 로그인 페이지 없이 GIF나 MP4 파일을 바로 여는지 확인한 다음, Pitchdeck에서 URL을 수정하고 다시 내보내세요. MP4 임베드는 **Include MP4 Video URL Embeds**를 켠 PowerPoint 내보내기에 적용돼요.

## 내보내기를 준비할 수 없는 문제

Pitchdeck이 내보내기 설정을 저장하지 못하면 파일을 생성하기 전에 멈추고 내보내기 버튼을 다시 사용할 수 있게 해요. 다시 내보내 보고, 문제가 계속되면 플러그인을 닫았다가 다시 여세요. 이 준비 단계에서 실패한 내보내기는 Pro 체험 내보내기 횟수를 차감하지 않아요.

## PPTX로 내보낸 파일에서 편집 가능한 텍스트의 위치가 어긋나는 문제

텍스트 레이어의 경계 상자에 Figma에서 고정 너비/높이가 지정되어 있고, 그 크기가 실제 텍스트 내용보다 작으면 위치 오프셋이 잘못 계산되는 경우가 많아요. Figma에서 텍스트 레이어의 크기 조정 옵션을 “Auto Height”로 바꾸면 해결될 거예요.

또 다른 흔한 원인은 Figma의 한 텍스트 레이어 안에 여러 줄 높이나 폰트 크기 값이 섞여 있는 경우예요. 아쉽게도 PPTX 파일은 Figma와 달리 텍스트 레이어 하나에 줄 높이 값을 하나만 지원하고, 한 텍스트 블록에 여러 폰트 크기가 있으면 PPTX 파일의 세로 흐름도 틀어져요.

이 문제를 해결하려면 Figma 텍스트 레이어 안에서 줄 높이나 폰트 크기가 다른 텍스트를 별도의 레이어로 분리하고, 다른 텍스트 레이어와의 관계에 맞게 원하는 위치에 배치하세요. 이렇게 하면 텍스트 블록마다 줄 높이와 폰트 크기 값이 하나씩만 남아요.

## 이미지가 픽셀이 깨진 채 내보내지는 문제

Figma의 이미지 에셋이 아직 점진적으로 로딩되는 중에 프레젠테이션을 내보내면, 이미지가 Figma 파일에서 완전히 로드되기 전에 내보내져 픽셀이 깨져 보일 수 있어요. 이 문제를 해결하려면 Pitchdeck 플러그인으로 프레젠테이션을 내보내기 전에 모든 이미지가 100% 로드되어 Figma 파일 안에서 선명하게 보이는지 확인하세요.

이 문제를 더 줄이려면 [TinyImage Figma 플러그인](https://www.figma.com/community/plugin/789009980664807964/TinyImage-Compressor)의 [“Downsizer” 기능](/ko/tinyimage/downsize)(영어)으로 이미지 채우기를 레이어 크기에 맞게 줄여 보세요. 파일 크기가 줄어들어 Figma 파일에서 훨씬 빠르게 로드돼요.

## Google Slides 이미지 크기와 PPTX 파일 제한

내보내기 설정에서 **Google Slides** 옵션을 선택하면, Pitchdeck은 래스터 이미지의 긴 쪽을 최대 1400px로 제한해요. 이렇게 하면 `.pptx` 파일이 작아지고, Google Slides로 가져올 때 변환에 실패하는 일이 줄어들어요.

내보낸 프레젠테이션이 여전히 Google Slides에 비해 너무 크다면, 덱을 더 작은 파일로 나누거나 원본 이미지 채우기의 크기를 줄인 다음 다시 내보내세요.

## Figma Prototype 임베드를 레이어 크기에 맞게 채우기

Pitchdeck에서 사용하는 Figma 레이어/임베드의 가로세로 비율에 따라, Prototype URL을 복사해 Pitchdeck 플러그인에 붙여 넣어 레이어에 임베드하기 전에 Figma Prototype의 크기 조정 옵션을 바꿔야 할 수도 있어요.

Figma Prototype을 연 상태에서 헤더 오른쪽 위의 **Options** 드롭다운을 클릭하고 **Fit Width** 크기 조정 옵션을 선택한 다음 Prototype URL을 복사해 Pitchdeck 레이어 임베드로 사용하세요. 그러면 Figma Prototype 임베드가 Figma 레이어 크기에 맞게 확대되거나 축소돼요(Figma 레이어의 가로세로 비율이 Figma Prototype의 가로세로 비율과 같아야 해요).

**Fit Width** 옵션이 보이지 않는다면, Figma Prototype 임베드 URL의 `scaling=` 매개변수를 직접 `scaling=scale-down-width`로 바꿔 보세요. 그러면 Figma Prototype이 **Fit Width** 크기 조정 옵션으로 표시돼요.

## 플러그인에서 슬라이드가 업로드되지 않거나 웹 앱에서 이미지가 로드되지 않는 문제

인터넷 서비스 제공업체(ISP)가 QUIC 프로토콜을 차단하고 있는 것이 원인일 수 있어요. 브라우저나 Figma에서 개발자 콘솔을 열었을 때 `ERR_QUIC_PROTOCOL_ERROR` 오류 메시지가 보이면 이 경우에 해당해요.

이 문제는 다음 방법으로 우회할 수 있어요.

1. 컴퓨터의 인터넷 연결을 휴대폰의 Wi-Fi 핫스팟/테더링으로 바꾸기
2. 브라우저에서 [QUIC 비활성화하기](https://kinsta.com/knowledgebase/err_quic_protocol_error/)(영어)

## ‘100% of memory used’ Figma 메모리 누수 문제

드물지만 알려진 버그로, Figma가 특정 복잡한 레이어에서 SVG 이미지 데이터를 추출하다가 메모리가 부족해질 수 있어요. 주로 여러 텍스트 레이어가 들어 있는 그룹이나 복잡한 단일 텍스트 레이어에서 발생해요(Figma에서 메모리를 더 많이 쓰는 사용자 지정 폰트를 사용하는 경우가 많아요).

이 오류가 발생하면 Pitchdeck 플러그인이 화면 아래쪽에 알림을 표시해 어떤 프레임의 어떤 레이어가 메모리 문제를 일으키는지 알려 줘요.

알림은 Figma 경고 대화 상자에서 “reload page”를 클릭하고, 페이지가 다시 로드되면 문제가 되는 레이어 이름 앞에 `[PNG]`를 붙이라고 안내해요(예: “[PNG] My original layer name”). 그러면 Pitchdeck 플러그인이 해당 레이어에 대해 SVG 이미지 데이터 대신 PNG 이미지 데이터를 가져오므로 메모리 문제가 해결돼요.

## 내보낸 이미지 테두리에 얇은 흰 선이 생기는 문제

가끔 이미지 가장자리에 희미하고 얇은 흰 선이 생길 수 있어요. 레이어가 정수 픽셀 값이 아닌 위치(예: Y: 156.76 또는 X: 56.3)에 놓여 있으면 Figma가 [이렇게 처리해서](https://twitter.com/Skcrub/status/1255544876701270017) 서브픽셀 선이 내보낸 파일에 자동으로 포함돼요. 이 문제를 해결하려면 레이어 위치가 모두 정수 픽셀 값인지 확인하세요.

## .pptx 내보내기에서 편집 가능한 텍스트에 그라디언트가 지원되지 않는 문제

Figma 디자인의 텍스트 레이어에 그라디언트 채우기를 사용하면, Pitchdeck은 첫 번째 그라디언트 채우기의 첫 번째 색상을 가져와 `.pptx` 내보내기 파일의 “단색”으로 자동 사용해요.

## .mp4 동영상 파일을 호스팅할 곳

동영상을 호스팅하기 좋은 방법 중 하나는 [Backblaze B2](https://www.backblaze.com/b2/cloud-storage.html)예요. 무료 계정으로 가입하면 10gb의 무료 저장 공간을 받을 수 있고, 공개 스토리지 버킷을 만들면 업로드한 동영상 파일의 링크를 복사해 `.mp4` 링크를 Pitchdeck에 붙여 넣을 수 있어요.

또 다른 인기 있는 파일 호스팅 방법은 [Dropbox](https://www.dropbox.com/)예요. `.mp4` 파일을 업로드한 다음 그 링크를 Pitchdeck 플러그인에서 사용하면 돼요. Pitchdeck이 `?dl=0`을 `?raw=1`로 자동으로 바꿔 링크가 Dropbox 웹사이트 플레이어가 아니라 동영상 파일을 직접 가리키도록 해 줘요.

## Figma 문서에 넣은 GIF

Figma는 GIF 내보내기를 기본적으로 지원하지 않기 때문에, Figma 디자인 안에 “직접” 추가한 GIF는 애니메이션이 재생되지 않아요. 움직이는 GIF를 사용하려면 Pitchdeck 플러그인 안에서 URL로 추가하세요.

## Windows용 Figma 데스크톱 앱에서 파일 확장자가 비어 있는 문제

Windows용 Figma 데스크톱 앱에서만 발생하는 알려진 문제로, Figma의 일반 파일 내보내기에서도 똑같이 일어나요. 파일을 저장할 때 “all files” 레이블이 보일 수 있어요. 이를 무시하고 “Save”를 클릭하면 올바른 확장자로 저장되어, 컴퓨터에 다운로드된 뒤 정상적으로 열 수 있을 거예요. 그래도 확장자 없이 저장된다면 파일 이름을 바꿔 올바른 확장자를 직접 붙이면 돼요.

## Google Slides의 100mb 파일 크기 제한

Google Slides는 가져오는 PPTX 파일 하나당 100mb 제한이 있어요. 이를 우회하려면 가져올 PPTX 파일을 ([이런 도구](https://products.aspose.app/slides/splitter)(영어)를 사용해) 더 작은 파일로 나눈 다음 Google Slides 파일에 하나씩 업로드하세요. 이렇게 하면 업로드 크기 제한을 피하면서도 모든 슬라이드를 한 파일에 담을 수 있어요.

## PDF 내보내기가 느리거나 멈추는 문제

PDF 내보내기가 아주 느리다면 일부 콘텐츠에 고해상도/대용량 이미지 채우기가 있거나, _그리고/또는_ 레이어에 큰 “Layer Blur” 효과가 많이 적용되어 있기 때문일 가능성이 높아요. 둘 다 Figma가 PDF를 생성하는 데 훨씬 오래 걸리게 만들어요.

이미지 채우기 문제는 [TinyImage](https://www.figma.com/community/plugin/789009980664807964/TinyImage-Compressor)의 [“Downsizer” 기능](/ko/tinyimage/downsize)(영어)으로 이미지 채우기를 레이어 크기에 맞게 줄이면 도움이 돼요. 파일 크기가 줄어들어 Figma 파일에서 훨씬 빠르게 로드돼요.

“Layer Blur” 문제는 해당 레이어를 평면 이미지 레이어로 바꾸면 도움이 돼요. Figma에서 레이어를 마우스 오른쪽 버튼으로 클릭하고 **Copy/Paste As** -> **Copy as PNG**를 선택한 다음, 레이어를 Figma 캔버스에 붙여 넣으세요(Mac에서는 **CMD + V**, Windows에서는 **CTRL + V**). 그런 다음 Figma 프레임/슬라이드 안의 같은 위치에 배치하고, 평면 PNG로 복사해 붙여 넣은 원본 레이어는 숨기거나 삭제하세요.

Figma 페이지의 이미지 채우기 크기를 줄이거나, “Blur” 효과가 있는 Figma 레이어를 평면 이미지로 바꾼 뒤에 Pitchdeck을 다시 실행해 PDF를 다시 내보내면 훨씬 빨라질 거예요.

## Adobe Acrobat에서 PDF를 편집할 때 점선이 보이는 문제

PDF를 편집하는 동안 Acrobat 앱 사이드바에서 “Show bounding boxes” 토글을 해제하면 해결돼요. PDF를 앱에서 열고 “Edit” 모드로 들어가면 [Adobe가 기본으로](https://archive.md/Uhdbk) 경계 상자 점선을 표시하지만, “Show bounding boxes” 토글을 끄면 클릭 한 번으로 숨길 수 있어요.

## PNG 이미지와 배경 투명도 강제 적용

Pitchdeck은 레이어에 완전히 투명한 영역이 있는지 자동으로 감지해 PNG를 기본 내보내기 형식으로 설정하고, 그렇지 않으면 JPG로 설정해요. Figma 레이어 이름에 **[PNG]** 를 추가하거나, Figma 오른쪽 열에서 레이어의 내보내기 형식을 JPG 또는 PNG로 설정해 이 동작을 바꿀 수 있어요.

## .pptx 내보내기에 빠진 사용자 지정 폰트 설치하기

Figma에서 사용한 폰트가 설치되지 않은 컴퓨터에서 내보낸 `.pptx` 파일을 열면 텍스트가 Figma 디자인과 다르게 보여요. 필요한 폰트를 설치하거나, 빠진 폰트를 필요에 따라 다른 폰트로 바꾸세요.

## 180일 후 프레젠테이션 URL 만료

프레젠테이션 URL은 180일 동안 사용되지 않으면(링크에 마지막으로 접근해 열람한 지 180일이 지나면) 자동으로 만료돼요. 만료된 URL을 다시 활성화하려면 해당 Figma 파일에서 Pitchdeck을 실행하고 Upload Web Presentation을 클릭하세요.

## Netskope가 Pitchdeck 웹 앱 로딩을 차단하는 문제

[Netskope](https://www.netskope.com/)가 Firebase 데이터베이스 접근을 차단하는 알려진 문제가 있어요. 해결하려면 `firestore.googleapis.com:443`을 허용하세요([이 스레드](https://stackoverflow.com/questions/52441316/firestore-grpc-behind-a-corporate-firewall-proxy)(영어) 참고).

## 중국에서는 VPN이 필요할 수 있어요

중국에 있다면 “만리방화벽(The Great Firewall of China)” 때문에 계정 서버에 연결하지 못할 _수도_ 있어요. 유효한 키를 입력했는데도 활성화 오류가 표시된다면 [VPN](https://protonvpn.com/free-vpn/)을 사용해야 문제가 해결될 가능성이 커요.

## ‘An error occurred while loading the plugin environment’ 오류

Figma 데스크톱 앱에서 [Use Developer VM](https://www.figma.com/plugin-docs/debugging/#developer-vm)(영어) 디버그 설정이 실수로 켜져 있으면 이 오류가 발생할 수 있어요. Figma 캔버스 아무 곳에서나 **마우스 오른쪽 버튼을 클릭**하고 **Plugins**, **Development** 순으로 마우스를 올린 다음 **Use Developer VM**이 *선택 해제*되어 있는지 확인하세요. 선택이 해제되면(옆에 체크 표시가 _없으면_) Figma 플러그인을 다시 실행했을 때 정상적으로 작동할 거예요.