내보내기 상세 설정
3.3.2602 버전부터 지원합니다.
사용 시 참고 사항
임포트된 원본 문서와 내보낸 문서의 표현 및 품질이 동일하다고 보장되지 않습니다.
웹 에디터 환경의 구조적 특성으로 인해 원본 문서 형식과 1:1로 일치시키는 것은 어렵고, 그 결과 일부 오브젝트가 누락되거나 비정상적으로 표시될 수 있습니다.
모듈 적용
내보내기 기능을 사용하려면 에디터 패키지의 externals 폴더에 포함된 임포트/내보내기 모듈 SEDocModelParser를 적용해야 합니다.
<!-- synapeditor.config.js -->
<!-- Import/Export module -->
<script src="externals/SEDocModelParser/SEDocModelParser.min.js"></script>
툴바 설정
에디터 툴바 설정에 'export'가 추가되면 내보내기 다이얼로그를 사용할 수 있습니다.
// synapeditor.config.js
{
'editor.toolbar': [..., 'export', ...]
}
내보내기 UI 다이얼로그

| 항목 | 설명 | 값 |
|---|---|---|
| 파일 형식 | 파일 형식을 지정합니다.공식적으로 지원되는 형식은 hwpx입니다.다른 형식(hwp, docx)은 변환 과정에서 일부 제한이 있을 수 있습니다. | HWPX (기본값)HWPDOCX |
| 용지 방향 | 용지 방향을 설정합니다. | A4 세로 (기본값)A4 가로 |
| 파일 이름 | 저장할 파일 이름을 입력합니다. | 문자열(입력하지 않을 경우: untitled) |
내보내기 시 생성된 파일은 사용 중인 브라우저의 기본 다운로드 폴더에 저장됩니다.
내보내기 확장자 설정
3.3.2603 버전부터 지원합니다.
내보내기 다이얼로그에 표시되는 파일 형식을 구성합니다.
- 구성된 확장자는 배열에 입력된 순서대로 표시됩니다.
- 빈 배열로 설정하면 파일 형식 항목이 표시되지 않습니다.
- 하나만 설정된 경우 해당 항목만 표시되며, UI가 비활성화되어 변경할 수 없습니다.
// synapeditor.config.js
{
'editor.export.extensions': ['docx', 'hwpx'] // default: ['docx', 'hwpx', 'hwp']
}
기본 내보내기 확장자 설정
3.3.2603 버전부터 지원합니다.
내보내기 다이얼로그에서 기본적으로 선택되는 파일 형식을 설정합니다.
기본 확장자를 지정하면 해당 형식이 먼저 선택됩니다. 그러나 내보내기 형식 목록에 없는 값은 적용되지 않습니다.
기본 확장자를 별도로 지정하지 않거나 사용할 수 없는 값으로 설정하면, 내보내기 형식 목록의 첫 번째 항목이 기본적으로 선택됩니다.
내보내기 형식 목록이 비어 있으면, 지원되는 형식 중 사용 가능한 값에 따라 기본 형식이 결정됩니다.
// synapeditor.config.js
{
'editor.export.defaultExtension': 'docx' // default: 'hwpx'
}
예시
| 설명 | 설정값 | 결과 화면 |
|---|---|---|
| 내보내기 확장자가 빈 배열로 설정된 경우 | 아래 빈 배열 참고. | ![]() |
| 내보내기 확장자가 하나만 설정된 경우 | 아래 단일 내보내기 확장자 참고. | ![]() |
| 두 개 이상의 내보내기 확장자가 설정되고 기본 내보내기 확장자가 변경된 경우 | 아래 기본값이 변경된 다중 내보내기 확장자 참고. | ![]() |
빈 배열
내보내기 확장자가 빈 배열로 설정된 경우.
// synapeditor.config.js
{
'editor.export.extensions': []
}
단일 내보내기 확장자
내보내기 확장자가 하나만 설정된 경우.
// synapeditor.config.js
{
'editor.export.extensions': ['hwpx']
}
기본값이 변경된 다중 내보내기 확장자
두 개 이상의 내보내기 확장자가 설정되어 있고 기본 내보내기 확장자가 수정된 경우.
// synapeditor.config.js
{
'editor.export.extensions': ['docx', 'hwpx'],
'editor.export.defaultExtension': 'docx'
}
관련 정보
- 내보내기 API 설정
exportFile(API > 에디터 객체)


