마크다운 글을 쓰면서 완성된 모양을 바로 보고 싶다면 ghostwriter를 써 볼 수 있습니다. KDE 공식 사이트는 Windows 10용 64비트 휴대용 파일을 무료로 안내하며, GitHub 공식 2.1.6 릴리스에는 ZIP 파일이 올라와 있습니다. Windows에서는 별도 설치 마법사 대신 ZIP을 풀어 사용하는 방식입니다.
이 편집기는 왼쪽에 마크다운 원문을 쓰고 오른쪽에 HTML 미리보기를 띄울 수 있습니다. 제목과 목록, 링크를 입력한 뒤 보이는 모양을 확인하고 .md 파일로 저장하는 작업을 아래에서 차례로 설명합니다. 처음부터 Word 파일이나 PDF를 만드는 도구로 생각하기보다 마크다운 문서를 편하게 작성하는 용도로 접근하면 이해하기 쉽습니다.
ghostwriter는 어떤 마크다운 편집기인가요?
ghostwriter는 글을 쓰는 화면을 단순하게 유지하면서 마크다운 문법에 색을 입혀 보여 주는 편집기입니다. 공식 사이트에는 전체 화면 글쓰기, 밝은색·어두운색 테마, HTML 실시간 미리보기, 문서 개요, 집중 모드, 글자 수 통계가 소개돼 있습니다. 문단 하나를 고치는 동안 결과 페이지를 매번 새로 열 필요가 없다는 점이 핵심입니다.
공식 HTML 미리보기 이미지에서는 편집 원문과 변환된 결과가 좌우로 나뉘어 있습니다. 왼쪽의 # 제목과 – 목록 기호가 오른쪽에서 큰 제목과 글머리표로 바뀌어 보입니다. 원문은 마크다운으로 보존되므로 블로그에 붙여 넣기 전에 구조를 검토하거나, 다른 편집기에서 다시 열어 수정할 수도 있습니다.
기본 마크다운 처리는 cmark-gfm을 내장합니다. 공식 문서는 Pandoc, MultiMarkdown, cmark도 별도로 설치하면 감지할 수 있다고 설명하지만 첫 HTML 미리보기를 쓰기 위해 이들을 모두 설치해야 하는 것은 아닙니다. 외부 처리기가 필요한 내보내기 형식은 선택한 도구와 설정에 따라 달라지므로, 이 글은 내장 기능으로 확인할 수 있는 글쓰기와 미리보기에 집중합니다.
공식 화면으로 편집·미리보기·문서 개요 확인하기
공식 사진에는 글쓰기 화면, 원문과 HTML이 나란한 미리보기, 제목별 개요 목록이 보입니다. 각 사진의 촬영 버전은 표기돼 있지 않아 2.1.6의 버튼 위치가 동일하다고 단정하지 않습니다.
| 프로그램 | ghostwriter |
| 제작·배포 | KDE community |
| 라이선스 | GPLv3 |
| Windows 파일 | 2.1.6 win64 portable ZIP |
| 다른 환경 | Linux 패키지 / macOS 소스 빌드 |
| 확인일 | 2026년 10월 20일 |
Windows에서 ghostwriter 2.1.6 파일 받기
KDE 다운로드 페이지는 Windows 10용 파일을 64비트 휴대용 버전으로 안내합니다. 공식 GitHub 릴리스의 ghostwriter_2.1.6_win64_portable.zip을 선택하세요. 이름에 win64와 portable이 함께 들어 있으므로 설치 프로그램 EXE나 MSI와 혼동하지 않아야 합니다. Windows가 64비트인지 설정의 시스템 정보에서 먼저 확인하면 파일 선택이 간단합니다.
ZIP을 다운로드한 다음에는 압축 파일 속에서 앱을 바로 열기보다 폴더에 압축을 풀어 두고 사용하는 편이 파일 위치를 잃지 않기 쉽습니다. 예를 들어 문서 작업 폴더와 별도의 ghostwriter 폴더에 풀고, 그 안의 프로그램을 실행합니다. 압축을 풀었다고 시스템 전체에 설치된 것은 아니므로 나중에 위치를 옮기면 바로가기 경로도 함께 바뀔 수 있습니다.
Linux 사용자는 배포판 저장소의 패키지를 확인하고, macOS는 공식 다운로드 페이지가 소스 빌드만 안내한다는 점을 먼저 알아두세요. Windows ZIP을 macOS에 받아도 실행되지 않습니다. 플랫폼별 방법을 하나의 설치 파일처럼 묶어 설명할 수 없어 아래 사용법은 Windows 휴대용 파일을 기준으로 합니다.
- Windows 10의 시스템 정보에서 64비트 운영체제인지 확인합니다.
- 공식 2.1.6 릴리스에서 win64_portable.zip 이름을 확인해 받습니다.
- 다운로드한 ZIP을 별도 폴더에 압축 해제하고 그 폴더의 ghostwriter를 엽니다.
마크다운 글을 쓰고 HTML 미리보기 켜기
처음 열었다면 새 문서에 짧은 테스트 글부터 써 보세요. 첫 줄에 '# 여행 준비 목록', 다음 줄에는 빈 줄을 넣고 '- 여권 확인'과 '- 숙소 주소 저장'을 입력합니다. #은 큰 제목, -는 글머리표가 됩니다. 저장할 때는 .md 확장자를 사용해 문서 자체가 마크다운 파일임을 분명히 하세요.
공식 제품 화면의 아래쪽에는 HTML 미리보기를 표시하는 아이콘이 있고, 미리보기 사진에는 원문 왼쪽과 결과 오른쪽이 함께 보입니다. 미리보기를 켠 뒤 방금 쓴 제목이 큰 글씨로, 준비 항목이 목록으로 보이는지 확인하세요. 글자를 고칠 때 오른쪽 결과도 따라 바뀌면 처음 목표인 실시간 확인까지 된 것입니다.
두 칸으로 나뉜 화면에서 폭이 좁게 느껴진다면 창을 넓히거나 구분선을 조절해 보세요. 글만 집중해서 쓰고 싶을 때는 미리보기를 잠시 숨겨도 .md 원문이 사라지지 않습니다. 공식 사이트가 소개하는 집중 모드는 현재 줄이나 문단을 강조하는 기능이므로, 미리보기와는 목적이 다릅니다.
마크다운은 눈에 보이는 서식과 원문 기호가 다릅니다. 제목 앞 # 뒤에 공백을 넣지 않거나 목록을 한 줄에 이어 쓰면 기대한 모양이 나오지 않을 수 있습니다. 왼쪽 입력을 조금 고친 다음 오른쪽 미리보기에서 그 자리의 제목·목록 구조가 바뀌는지 확인하면 오류를 빨리 찾을 수 있습니다.
- 새 문서에 # 제목과 – 목록 두 줄 이상을 입력합니다.
- HTML 미리보기를 켜서 원문과 결과를 나란히 봅니다.
- 제목 크기와 목록 모양을 확인한 뒤 .md 파일로 저장합니다.
긴 글은 개요를 보고 필요한 부분으로 이동하기
제목이 여럿인 문서에서는 개요 사이드바가 도움이 됩니다. KDE 공식 설명에 따르면 Ctrl+J로 개요 탭을 열고, 화살표 키로 제목을 고른 뒤 Enter를 눌러 해당 부분으로 이동할 수 있습니다. 공식 사진에는 상위 제목 아래 들여쓴 하위 제목이 보여 문서 구조를 한눈에 볼 수 있습니다.
예를 들어 '# 여행 준비' 아래에 '## 출발 전'과 '## 현지에서'를 추가해 보세요. 개요에서 두 소제목이 상위 제목 아래에 놓이는지 보고, 원하는 소제목을 선택합니다. 이동한 자리에서 문장을 고친 뒤 미리보기에도 같은 부분이 반영되는지 확인하면 긴 글의 편집 흐름을 익힐 수 있습니다.
개요에 제목이 예상과 달리 보이면 먼저 왼쪽 원문의 # 개수와 공백을 살펴보세요. #은 상위, ##은 그 아래 수준입니다. 단순히 큰 글씨처럼 보이게 하려고 제목 수준을 건너뛰면 목차를 읽을 때 흐름이 어색해질 수 있습니다. 글을 마친 뒤에는 개요를 훑으며 제목이 빠진 문단이나 같은 이름의 소제목이 없는지도 확인하세요.
블로그에 쓸 글이라면 미리보기에서 보이는 HTML을 복사해 붙여 넣는 기능도 공식 사이트에 소개돼 있습니다. 다만 붙여 넣을 대상의 편집기가 HTML을 그대로 받는지, 일반 텍스트로 처리하는지 확인해야 합니다. 원본 .md 파일을 먼저 저장해 두면 붙여 넣은 결과가 마음에 들지 않아도 글을 다시 편집할 수 있습니다.
공식 사이트는 자동 저장과 파일 백업 옵션도 소개합니다. 긴 글을 쓰기 전에 설정에서 원하는 저장 방식을 확인하고, 작업이 끝나면 실제 .md 파일이 의도한 폴더에 있는지 직접 살펴보세요. 미리보기 화면에 글이 보인다는 사실만으로 파일 저장까지 마쳤다고 생각하면 다음에 원본을 찾기 어려울 수 있습니다.
- # 상위 제목과 ## 하위 제목을 만들고 Ctrl+J로 개요를 엽니다.
- 화살표 키로 이동할 제목을 선택해 Enter를 누릅니다.
- 해당 문단을 수정한 뒤 원문 .md 파일을 저장하고 미리보기를 확인합니다.
미리보기나 파일 열기가 예상과 다를 때
오른쪽 HTML 화면이 보이지 않으면 미리보기 표시가 꺼져 있는지부터 확인하세요. 두 칸 화면에서 경계가 한쪽 끝으로 밀려 결과가 좁게 보일 수도 있습니다. 내장 cmark-gfm만으로 기본 제목과 목록은 처리할 수 있으므로 외부 변환 도구가 없다는 이유로 미리보기가 무조건 작동하지 않는 것은 아닙니다.
일부 문법이나 수식 결과가 기대와 다르다면 선택한 마크다운 처리기를 확인하세요. 공식 문서는 cmark-gfm 내장과 Pandoc 등의 별도 감지를 구분합니다. 외부 처리기를 선택했는데 해당 프로그램이 설치돼 있지 않다면 기본 처리기로 바꿔 간단한 # 제목부터 시험해 보세요. 다른 엔진의 확장 문법을 같은 방식으로 표시한다고 가정하지 않는 편이 좋습니다.
받은 파일을 열 수 없다면 ZIP을 완전히 받았는지, Windows용 64비트 파일이 맞는지 확인하고 공식 릴리스에서 이름을 다시 비교하세요. Windows 10용 휴대용 빌드에는 맞춤법 검사에 필요한 Hunspell 사전이 기본으로 준비되지 않을 수 있습니다. 릴리스 안내는 사전을 따로 넣어야 맞춤법 검사를 사용할 수 있다고 설명합니다. 빨간 밑줄이 안 나온다고 글쓰기와 HTML 미리보기 자체가 실패한 것은 아닙니다.
공식 사이트의 예시 이미지는 편집기 기능을 이해하기 위한 자료입니다. 게시 날짜가 표시되지 않아 2.1.6의 현재 창을 직접 확인한 증거로 볼 수는 없습니다. 실제 화면의 아이콘이나 메뉴 배치가 다르면 기능 이름을 기준으로 찾아보고, 사용 중인 빌드의 도움말을 확인하세요.
자주 묻는 질문
ghostwriter는 무료인가요?
네. KDE 공식 사이트는 무료 오픈소스 소프트웨어로 소개하며 GPLv3 라이선스를 안내합니다.
Windows에서는 어떤 파일을 받아야 하나요?
공식 2.1.6 릴리스의 ghostwriter_2.1.6_win64_portable.zip입니다. Windows 10용 64비트 휴대용 파일입니다.
미리보기를 쓰려면 Pandoc도 설치해야 하나요?
기본 cmark-gfm 처리기가 내장돼 있어 기본 마크다운 HTML 미리보기에 Pandoc 설치가 필수는 아닙니다.
작성한 원본 글은 어떤 형식으로 저장하나요?
마크다운 원문을 .md 파일로 저장하면 됩니다. HTML 미리보기는 화면에서 결과를 확인하는 기능입니다.
macOS 설치 파일도 있나요?
공식 다운로드 페이지는 macOS용 설치 파일 대신 소스 빌드를 안내합니다. Windows ZIP은 macOS용이 아닙니다.
첫 마크다운 문서를 미리보며 완성하기
Windows 10 64비트라면 공식 2.1.6 휴대용 ZIP을 받아 폴더에 풀고 ghostwriter를 열어 보세요. # 제목과 – 목록이 들어간 짧은 글을 작성한 뒤 HTML 미리보기를 켜면 원문과 결과가 어떻게 연결되는지 바로 알 수 있습니다.
제목이 많아지면 개요에서 원하는 부분으로 이동하고, 끝으로 .md 원본을 저장하세요. 미리보기에서 제목과 목록 모양을 한 번 확인하면 다른 곳에 글을 옮기기 전의 기본 점검도 마친 셈입니다.
공식 자료와 확인일
ghostwriter KDE 공식 사이트 · ghostwriter 공식 다운로드 안내 · ghostwriter 2.1.6 공식 릴리스 · ghostwriter 공식 문서 · ghostwriter 공식 저장소와 라이선스 | 2026-10-20
