한글 문서에 맞춘 WYSIWYG 에디터입니다. 병합 셀 표, 워드 · 한글 · 엑셀 붙여넣기 정리, pt 글자 크기와 한국어 글꼴, 찾기 · 바꾸기, 인쇄를 갖췄고 React · Vue · Svelte · Angular · jQuery · 웹 컴포넌트에서 같은 옵션으로 씁니다.
빈 줄에서 # · - · 1. · [ ] · > 뒤에 공백을, 또는 ``` · ---를 쳐 보세요. 블록이 바로 바뀝니다.
게시판 글쓰기
@aeriz/wysiwyg · JS 24줄
말머리 · 제목 · 본문을 쓰고 등록하면 AerizViewer가 글 보기 화면을 그립니다. 툴바는 필요한 버튼만 골랐습니다.
aeriz 커뮤니티 › 등산 게시판 › 글쓰기
산타는개발자 · 방금 전 · 조회 1
지난 토요일, 우이역에서 출발해 백운대까지 다녀왔습니다. 날씨가 맑아서 정상에서 서울이 한눈에 보였어요.
코스와 시간
구간
거리
걸린 시간
우이역 → 하루재
2.1 km
50분
하루재 → 백운대
1.6 km
1시간 10분
합계 (올라가는 길)
2시간
챙기면 좋은 것
장갑 — 정상 직전 쇠줄 구간이 미끄러워요
물 1리터, 간단한 간식
그림은 끌어다 놓거나 붙여넣으면 바로 들어갑니다. 표 안을 눌러 행을 더해 보세요.
붙여넣기 시험장
@aeriz/wysiwyg · JS 44줄
엑셀 · 워드 · 한글이 클립보드에 넣는 지저분한 HTML(을 본뜬 견본)과 악성 코드가 든 웹 글을 붙여넣어 보세요. 서식은 남기고 mso-* · 이벤트 속성 · javascript:는 버립니다. 오른쪽에서 저장되는 HTML · JSON · Markdown을 바로 봅니다.
붙여넣기:
위 버튼을 누르면 오피스가 클립보드에 넣는 모양의 HTML을 그대로 붙여넣습니다. 직접 복사해 붙여넣어도 됩니다.
업무 보고서
@aeriz/wysiwyg · JS 14줄
결재란과 병합 셀 표가 있는 사내 문서 양식. 양식은 HTML 그대로 넣고, 결재를 올리면 setReadOnly(true)로 잠급니다.
주간 업무 보고서.doc결재 완료 · 고칠 수 없음
결재
담당
팀장
본부장
김에리즈
주간 업무 보고서
부서
플랫폼개발팀
기간
2026. 11. 9. ~ 11. 13.
작성자
김에리즈 책임
보고일
2026. 11. 13.
1. 금주 실적
과제
진척률
비고
계획
실적
결제 모듈 개편
80%
85%
조기 달성
관리자 화면 표 편집
60%
55%
QA 하루 늦어짐
문서 사이트 예제
100%
100%
배포 완료
2. 차주 계획
결제 모듈 부하 시험 (11. 16.)
관리자 화면 QA 마무리
보안 점검 결과 반영
3. 협조 요청
QA 장비 1대 추가 — 11. 17.까지 회신 부탁드립니다
댓글 입력창
@aeriz/wysiwyg · JS 22줄
같은 에디터를 툴바 4칸, 높이 110px, 상태 표시줄 없이 줄였습니다. Ctrl + Enter로 등록합니다.
댓글 2
표덕후
병합 셀 있는 표에 행을 넣어도 줄이 안 밀리네요. 이거 좋다
10분 전
한글러
한글 문서에서 붙여넣었는데 자간까지 그대로예요.
3분 전
Ctrl + Enter로 등록
설치
사용하는 패키지 매니저를 고르세요. 빌드 도구 없이 쓰려면 CDN 탭을 보세요.
bash
npminstall @aeriz/wysiwyg
bash
pnpmadd @aeriz/wysiwyg
bash
yarnadd @aeriz/wysiwyg
html
<linkrel="stylesheet"href="https://cdn.jsdelivr.net/npm/@aeriz/wysiwyg@2.0.1/dist/aeriz-wysiwyg.min.css"><!-- 전역 AerizWysiwyg --><scriptsrc="https://cdn.jsdelivr.net/npm/@aeriz/wysiwyg@2.0.1/dist/aeriz-wysiwyg.min.js"></script><!-- 코드 색칠이 필요하면 (전역 AerizWysiwygHighlight) --><scriptsrc="https://cdn.jsdelivr.net/npm/@aeriz/wysiwyg@2.0.1/dist/aeriz-wysiwyg-highlight.min.js"></script>
스타일시트는 어느 방법이든 한 번 불러야 합니다. 번들러에서는 import '@aeriz/wysiwyg/style.css'로 부릅니다.
Tip CDN 주소에는 @2.0.1처럼 정확한 버전을 적으세요. 바뀌지 않는 주소라 오래 캐시됩니다.
빠른 시작
요소 하나를 넘기면 됩니다. height를 주면 본문이 그 높이 안에서 스크롤되고, 주지 않으면 부모 높이를 채웁니다(최소 320px).
import'@aeriz/wysiwyg/jquery'; // 전역 jQuery가 있으면 자동 등록$('#editor').aerizEditor({ value: '<p>안녕하세요</p>', height: 480 });
$('#editor').aerizEditor('getHTML');
$('#editor').aerizEditor('destroy');
서버 · 엣지
@aeriz/wysiwyg/server는 CSS를 불러오지 않고 document를 쓰지 않아 Node, Deno, Bun, Cloudflare Workers에서 그대로 돕니다.
js
import { renderBlocksToHTML, blocksToMarkdown, blocksToPlainText } from'@aeriz/wysiwyg/server';
const html = renderBlocksToHTML(post.blocks, { wrapper: 'content' }); // 같은 입력이면 늘 같은 출력const text = blocksToPlainText(post.blocks); // 검색 색인용
표
표 안에 캐럿을 두면 툴바에 표 메뉴와 칸 배경색이 나옵니다. 칸을 끌어 여러 개 고를 수 있습니다.
동작
병합 셀이 있을 때
열 넣기
병합 머리글 안쪽이면 머리글이 넓어지고, 위아래 병합 셀 옆이면 새 칸도 같은 높이입니다.
행 넣기
위아래 병합 셀을 가로지르면 그 셀이 한 줄 길어집니다.
행 · 열 지우기
병합 셀이 시작하는 행을 지우면 셀이 아래로 내려가고, 병합 머리글은 한 칸 줄어듭니다.
병합
고른 범위가 다른 병합 셀에 반쯤 걸치면 범위를 넓혀 통째로 합칩니다. 글은 줄을 바꿔 잇습니다.
분할
1칸짜리로 되돌리고, 빈 칸을 채워 직사각형을 유지합니다.
Tab
격자 순서로 다음 칸. 마지막 칸에서는 새 행을 만듭니다.
붙여넣기
어디서
남는 것
버리는 것
엑셀
병합, 굵기, 배경색, 테두리, 정렬, 글자색
mso-number-format, 클래스, <col>, 칸 공통 글꼴
워드
굵게 · 기울임, 들여쓰기, 글머리 · 번호 목록(중첩 포함)
mso-list 문단, Wingdings 글머리, <o:p>, lang
한글
들여쓰기, 자간, 글꼴(<font>는 <span style>로), 칸 너비와 배경
HStyle 클래스, style-name, 칸 안의 빈 문단, 기본 크기(size="3")
구글 문서
문단 · 제목 · 목록 · 굵게
전체를 감싼 <b id="docs-internal-guid-…">, 목록 항목 안의 <p>
웹
문단 · 제목 · 목록 · 표 · 링크
스크립트, 이벤트 속성, 블록 id
이 에디터
문서에 있는 그대로(서식 · 링크 · 목록 · 표 구조)
브라우저가 덧입히는 계산된 스타일(font-size: 15px 등), 정렬 단추 · 크기 손잡이
블록을 품은 링크 · 굵게(<a><p>…</p></a>)는 껍데기를 풀고 안쪽 글마다 다시 입힙니다. 문단 안에 문단이 들어가지 않습니다.
목록 항목 · 표 칸 · 그림 설명처럼 블록을 둘 수 없는 자리에는 인용 · 콜아웃까지 줄바꿈으로 이은 글로 넣습니다.
그런 자리에 온 링크 카드 · 파일 · 영상은 주소를 잇는 링크 한 줄(카드 제목 · 파일 이름)이 됩니다. 인용 · 콜아웃 안에 붙여넣은 카드 · 파일 · 영상은 속을 채워 상자 밖으로 꺼냅니다.
한 표의 여러 칸에 걸쳐 고른 채 붙여넣으면 칸은 그대로 두고 고른 글만 지운 뒤 첫 칸에 넣습니다. 표 모양이 깨지지 않습니다.
그림 · 링크 카드 위에 캐럿이 있으면 그 뒤 문단에 넣고, 블록에 걸친 선택 위에 붙여넣으면 선택부터 지웁니다.
링크 글 안에 주소를 붙여넣으면 주소 글자만 들어갑니다. 링크 안에 링크가 생기지 않습니다.
길이의 pt는 px로 바꾸고 글자 크기는 pt 그대로 둡니다. Ctrl+Shift+V는 서식 없이 붙여넣고, 그림 파일을 붙여넣거나 끌어 놓으면 upload로 올립니다.
기본 글꼴은 맑은 고딕, 굴림, 돋움, 바탕, 궁서, 나눔고딕, 나눔명조, Apple SD 산돌고딕 Neo, Arial, Times New Roman, Courier New입니다. 이 기기에 없는 글꼴은 목록에서 빠집니다.
cssUrl을 준 글꼴만 글꼴 목록을 열 때 그 CSS를 받습니다. 그 밖에는 외부 요청이 없습니다.
줄 간격은 100~300%, 자간은 em 단위입니다. 특수 문자는 기호 · 화살표 · 원문자 · 단위 · 괄호 · 수학 묶음으로 고릅니다.
무료 글꼴 (SIL OFL 1.1)
저작권 걱정 없이 쓸 수 있는 한글 글꼴 15종을 FREE_FONTS로 담아 두었습니다. 글꼴 파일은 패키지에 들어 있지 않고, 기본으로 부르는 CDN 주소도 없습니다. 쓰는 쪽에서 호스팅한 CSS 주소를 freeFonts({ cssUrl })로 넘기면 그 글꼴만 글꼴 목록을 열 때 받습니다.
js
import { AerizEditor, freeFonts } from'@aeriz/wysiwyg';
newAerizEditor({
element,
// 기본 목록(DEFAULT_FONTS) 뒤에 붙고, 겹치는 나눔고딕 · 나눔명조는 그 자리에 주소만 채웁니다.
fonts: freeFonts({
only: ['pretendard', 'noto-serif-kr', 'd2coding'], // 빼면 전부
cssUrl: (font) => `/fonts/${font.id}/font.css`, // 직접 올린 CSS
}),
});
cssUrl을 주지 않은 글꼴은 이 기기에 깔려 있을 때만 목록에 보입니다. freeFonts()는 어디로도 요청을 보내지 않습니다.
글꼴 파일을 직접 올려 배포할 때는 각 글꼴의 OFL.txt를 함께 두세요. OFL은 상업용 · 웹 임베딩을 허용하며, 글꼴 파일만 따로 파는 것은 금지합니다.
기본 목록의 맑은 고딕 · 굴림 · 바탕 같은 시스템 글꼴은 기기에 깔린 것을 쓸 뿐 파일을 나눠 주지 않습니다.
툴바: 줄 간격, 자간, 특수 문자, 찾기 · 바꾸기, 소스 보기, 인쇄, 전체 화면, 표 메뉴의 셀 병합 · 분할.
2.0.1에서 바뀐 것
npm 2.0.0 이후의 변경입니다. 저장해 둔 스냅샷 · HTML은 그대로 열리고, 공개 API는 늘기만 했습니다.
전체 변경 내역 보기
저작권 정리
툴바 · 블록 아이콘을 이 패키지에서 처음부터 다시 그렸습니다(20×20 격자, 선 굵기 1.6). 다른 아이콘 세트에서 가져온 그림은 없습니다.
링크 카드가 기본으로 구글 파비콘 서비스를 부르지 않습니다. 파비콘이 필요하면 favicon 옵션으로 주소를 정하세요. 주지 않으면 파비콘 없이 그리고 외부 요청도 없습니다.
라이선스를 확인한 무료 한글 글꼴 15종을 FREE_FONTS · freeFonts()로 넣었습니다(모두 SIL OFL 1.1). 글꼴 파일은 패키지에 넣지 않았고 기본 CDN 주소도 없습니다.
새 기능
코드 언어 자동 인식: 붙여넣은 코드의 language-* 클래스 · data-lang, 마크다운 펜스 별칭(py · sh · c++)을 읽습니다. ``` 다음 첫 줄에 언어 이름을 쓰고 Enter를 누르면 그 언어로 정해집니다.
링크: Ctrl+K로 넣기 · 고치기 · 해제. https://… · www.… 뒤 띄어쓰기 · Enter는 자동 링크, 주소 하나를 붙여넣으면 링크(글을 고른 채면 그 글에), 빈 본문에 유튜브 주소를 붙여넣으면 영상 블록. example.com · 메일 주소는 https:// · mailto:로 보정합니다. 링크 카드를 누르면 새 탭 대신 편집 창이 열립니다.
체크리스트 입력 규칙: 문단이나 글머리 목록 항목 맨 앞에서 [ ] · [] · [x] (완료). Ctrl+Z 한 번이면 친 글자로 돌아갑니다.
가져온 HTML 블록은 내용 높이로 펼쳐집니다(고정 머리글 · 안쪽 스크롤 상자를 풂). 아래 가장자리를 끌면 높이가 정해지고, 두 번 누르면 내용 높이로 돌아갑니다. 정한 높이는 getHTML() · 뷰어 · Markdown 내보내기에도 그대로 나갑니다.
되돌리기: 띄어쓰기마다 끊어 한 번에 낱말 하나씩 되돌리고, 캐럿은 그 변경 직전 자리로 돌아갑니다. 브라우저 편집 메뉴 · 오른쪽 클릭 메뉴의 되돌리기도 에디터 이력을 씁니다.
macOS Cmd+Option 블록 단축키는 자판 위치로 찾고, 유럽 자판의 AltGr 글자(AltGr+7 = {)는 가로채지 않습니다.
편집 동작 (블록 경계)
Enter: 제목 끝에서는 다음 줄이 본문, 목록 빈 항목에서는 목록을 빠져나온 본문, 인용 · 콜아웃 · 토글은 빈 마지막 줄에서 빠져나옵니다. 코드 블록은 윗줄 들여쓰기를 잇고 빈 마지막 줄 Enter · Ctrl+Enter로 빠져나옵니다.
Backspace · Delete로 문단을 합쳐도 <span style>이 생기지 않습니다. 표 · 코드 블록과는 합치지 않고, 구분선 · 그림 · 영상 · 링크 카드 · 파일은 빨간 테두리로 한 번 표시한 뒤 지웁니다.
여러 블록에 걸친 선택 · 세 번 클릭 · Ctrl/Cmd+A 뒤 입력 · 지우기 · 잘라내기는 고른 부분만 지우고 이어 씁니다. Ctrl/Cmd+A는 카드 · 표로 시작하거나 끝나는 문서도 끝까지 고릅니다.
구분선 · 영상 · 링크 카드 · 표를 넣으면 쓰던 문단을 바꾸지 않고 그 뒤에 넣습니다. 편집 중 영상 첫 클릭은 블록 고르기라 키가 재생기로 넘어가지 않습니다.
복사 · 잘라내기는 문서에 있는 요소만 싣습니다(브라우저의 계산된 스타일이 붙지 않음). 대화 상자를 닫으면 열기 전 캐럿으로 돌아갑니다.
모르는 블록(<div class> · <section>)은 본문 단락이 되고, 인용 안 카드 · 인용 안 인용 · 빈 표 · 링크 안 링크 같은 깨진 구조는 생기는 즉시 바로잡습니다. 표 칸 안에서는 글 블록 유형 바꾸기를 하지 않습니다.
표 · 붙여넣기 · 체크리스트
툴바의 표 크기 고르기 칸과 열 너비 끌기가 한 프레임에 한 번만 그려 끊김 없이 따라옵니다. 칸 오른쪽 가장자리를 끌지 않고 누르기만 하면 캐럿이 그 칸에 들어갑니다.
한글 · 옛 웹 페이지의 <font face color size>는 글꼴 · 색 · 크기 도구가 읽는 <span style>이 됩니다. 링크 글 안에 주소를 붙여넣으면 주소 글자만 들어갑니다.
속 없이 속성만 온 링크 카드 · 파일 · 영상 HTML(서버 정화를 거친 HTML 등)도 에디터에서 다시 그립니다.
완료한 체크리스트 항목을 저장했다 다시 불러온 뒤 완료를 풀어도 회색 · 취소선이 남던 문제를 고쳤습니다.
배포
번들러가 고르는 ES 모듈과 서버 · 색칠기 · 프레임워크 연동 파일을 실제로 압축했습니다. 본체 ES 모듈은 422 KB → 295 KB(gzip 113 KB → 83 KB), npm 패키지는 904 KB → 871 KB입니다. 자세한 것은 배포 파일을 보세요.
예제 페이지를 더했습니다: 블록 갤러리, 게시판 글쓰기, 댓글, 붙여넣기 시험장, 보고서.
고친 것
코드 블록에서 한글을 조합하는 도중 언어를 바꾸면 글자가 두 번 들어가고 색칠이 멈추던 문제.
인용 · 콜아웃 안에 붙여넣은 링크 카드가 빈 상자로 남고 파일 · 영상이 사라지던 문제. 목록 항목 · 표 칸에 붙여넣은 카드 · 파일 · 영상이 사라지던 문제(이제 주소 링크로 남음).
카드 · 영상으로 끝나게 붙여넣은 뒤 영상을 누르면 이어 친 글자가 재생기로 넘어가던 문제. 파일 칸 · 링크 카드를 누르거나 끈 뒤 친 글자가 사라지던 문제.
인용 · 콜아웃 · 토글 안 코드 블록에서 Enter가 코드 블록을 문단으로 감싸 되돌리기 왕복 뒤 모양이 바뀌던 문제.
표의 여러 칸에 걸친 선택 위에 붙여넣으면 칸이 지워져 표가 직사각형이 아니게 되던 문제.