MacDown

어떤 작업에 적합한가

MacDown은 Mac에서 README, 기술 메모, 블로그 초안처럼 Markdown 파일을 직접 작성하는 사람에게 적합하다. 원문과 미리보기를 함께 보면서 제목 단계, 목록, 링크, 코드 블록의 모양을 확인하는 방식이다.

문서 내용과 서식을 일반 텍스트로 관리하려는 작업에 잘 맞는다. 공동 편집이나 게시 기능이 필요하다면 해당 기능을 제공하는 별도 도구까지 검토해야 한다.

주요 기능과 문법 설정

미리보기에는 Hoedown 렌더러를 사용한다. 표나 취소선 같은 확장 문법은 설정에 따라 결과가 달라지므로, 사용할 문법을 먼저 정하는 것이 좋다. 공식 FAQ는 GitHub 방식에 가깝게 작성하려면 Markdown 설정에서 Tables, Fenced code blocks, Strikethrough, Autolink를, Rendering 설정에서 Task list syntax를 켜도록 안내한다.

코드 블록은 언어 식별자를 지정하면 구문 강조를 적용할 수 있다. 수식과 Jekyll front-matter도 지원하지만, 다른 서비스로 옮길 문서라면 목적지에서도 같은 문법을 처리하는지 확인해야 한다.

설치와 첫 문서 작성 순서

공식 홈페이지의 다운로드 링크에서 배포 파일을 받은 뒤 압축을 풀고, MacDown 앱을 Applications 폴더로 옮기는 것이 공식 저장소의 설치 안내다. 이 설명은 문서에 근거한 절차이며 실제 설치나 실행 검증은 하지 않았다.

처음에는 새 문서에 제목, 짧은 문단, 목록을 작성하고 .md 파일로 저장한다. 미리보기에서 구조를 확인한 뒤 표와 작업 목록 등 필요한 확장 기능을 켠다. 이미지를 넣을 때는 문서와 이미지의 보관 위치를 먼저 정해 두면 파일을 옮길 때 경로를 점검하기 쉽다.

실무 예시: 프로젝트 인수인계 문서

프로젝트 인수인계용 README에 개요, 실행 절차, 담당자 목록, 미완료 작업을 작성할 수 있다. 실행 명령은 언어 식별자가 있는 코드 블록으로 구분하고, 남은 일은 작업 목록으로 표시한다. 화면 설명이 필요하면 이미지를 편집기에 끌어놓아 이미지 문법을 삽입한다.

이때 삽입되는 것은 로컬 경로이므로, 문서만 전달하면 상대방에게 이미지가 보이지 않을 수 있다. 전달 전에 이미지 파일을 함께 묶고 경로를 점검하며, GitHub 등에 올릴 문서는 최종 게시 환경에서도 표와 작업 목록을 다시 확인하는 편이 좋다.

비용과 버전, 유지보수 검토

MacDown은 MIT 라이선스로 공개되며 공식 홈페이지에서 무료로 내려받을 수 있다. 별도 유료판이나 무료판의 문서 수·사용 기간 제한은 확인한 공식 자료에 안내되어 있지 않다. 후원은 선택 사항이고, FAQ는 후원에 따른 별도 보상을 제공하지 않는다고 설명한다.

2026-10-09 확인 기준 공식 홈페이지와 GitHub 최신 안정판 표시는 0.7.3이다. 공식 안정판 이력의 날짜는 2020-01-03이며, 수정 내용은 환경설정 창 버그 해결이다. 입력된 0.7.2를 최신 버전으로 소개하면 안 된다. 장기간 안정판 갱신이 없다는 점은 도입 검토 항목으로 표시하되, 공식 지원 종료 선언을 확인한 것은 아니다.

문제가 생겼을 때 확인 순서

표나 작업 목록이 일반 텍스트처럼 보이면 먼저 관련 확장 옵션을 확인하고, 짧은 예제로 문법을 점검한다. 코드 색상이 나오지 않으면 코드 블록의 울타리와 언어 식별자를 확인한다. 이미지가 보이지 않으면 삽입된 경로와 실제 파일 위치를 비교한다.

앱 실행이 차단되는 문제는 공식 FAQ에도 등장하지만, 안내 화면과 절차가 오래되어 최신 macOS에 그대로 적용된다고 단정할 수 없다. 다운로드 출처와 운영체제의 현재 안내를 확인한다. 계속되는 오류는 앱 버전, macOS 버전, 재현 가능한 최소 문서를 정리하고 공식 GitHub 이슈에서 기존 보고를 찾아본다.

다른 도구와 선택 기준

MacDown은 Markdown 문서 한 편을 원문과 미리보기로 확인하는 작업을 중심으로 선택할 수 있다. 여러 문서의 제목을 검색하거나 파일·이미지 링크를 검증해야 한다면 VS Code도 비교할 만하다. VS Code 공식 문서는 작업 공간의 제목 탐색, 경로 자동 완성, 로컬 링크 검증과 나란히 보는 미리보기를 안내한다.

선택 기준은 화면의 단순함뿐 아니라 문서 규모, 링크 관리 필요성, 현재 운영체제와의 호환성이다. 특히 새 Mac에 도입할 때는 MacDown의 오래된 배포 기록을 함께 고려해야 한다.

공식 안내

• MacDown: The open source Markdown editor for macOS · 확인 2026-10-09
• Main Features — MacDown · 확인 2026-10-09
• Frequently Asked Questions — MacDown · 확인 2026-10-09
• Version History (Stable Channel) — MacDown · 확인 2026-10-09
• MacDownApp/macdown — 공식 저장소 README · 확인 2026-10-09
• Release Version 0.7.3 — MacDownApp/macdown · 확인 2026-10-09
• Markdown and Visual Studio Code · 확인 2026-10-09