내장 브라우저 없이 네이티브로 그리는 마크다운 편집기
C# / .NET 10 / Avalonia로 만든 마크다운 편집기입니다. 미리보기를 내장 브라우저 없이 네이티브 컨트롤로 직접 그립니다.
이 결정 하나가 나머지 전부를 결정합니다. Electron도 WebView도 쓰지 않으므로 배포본에 Chromium이 없고, 세 OS에서 렌더링이 픽셀 단위로 같으며, 시스템 테마와 글꼴 설정을 그대로 따릅니다. 대신 브라우저가 있어야 하는 것(Mermaid 다이어그램 등)은 소스 카드로 보여줍니다.
편집 — GFM 전체 지원, TextMate 문법 강조, 다중 커서, Vim 키 바인딩(문서), 명령 팔레트, 폴더 전체 찾기·바꾸기
미리보기 — 네이티브 렌더링, 스크롤 동기화, 수식(TeX 부분집합), 표·각주·정의 목록, 편집 중 증분 갱신
문서 — 탭, 세션 복구, 자동 저장, 개요 패널, 링크·구조 검사, HTML·PDF 내보내기
그 외 — 라이트/다크(시스템 연동), 7개 언어, 자동 업데이트(Windows), 파일 연결
최신 릴리스에서 받으세요. 전부 자체 포함이라 .NET 런타임을 따로 깔 필요가 없습니다.
| 플랫폼 | 파일 | 비고 |
|---|---|---|
| Windows 10/11 (x64) | MarkdownStudio-Setup-*.exe |
설치마법사. 사전 요구사항 없음 |
| Windows (포터블) | MarkdownStudio-*-portable.zip |
압축 풀고 바로 실행 |
| macOS (Apple Silicon) | MarkdownStudio-*-arm64.dmg |
macOS 12+ |
| macOS (Intel) | MarkdownStudio-*-x64.dmg |
macOS 12+ |
| Debian / Ubuntu | markdown-studio_*_amd64.deb |
sudo apt install ./파일.deb |
| Fedora / RHEL / openSUSE | markdown-studio-*.x86_64.rpm |
sudo dnf install ./파일.rpm |
| 모든 Linux | Markdown_Studio-*.AppImage |
chmod +x 후 실행 |
무결성 검증은 sha256sum -c SHA256SUMS.
Windows — 서명되지 않은 빌드라 SmartScreen이 한 번 경고합니다(추가 정보 → 실행). 설치마법사는 기본이 사용자 단위 설치라 관리자 권한이 필요 없고, 시스템 전역을 고른 경우에만 권한 상승을 요청합니다. 무인 배포:
MarkdownStudio-Setup-*.exe --silent --allusers --dir="C:\Program Files\Markdown Studio"
MarkdownStudio-Setup-*.exe --silent --uninstallmacOS — 공증되지 않았으므로 첫 실행은 앱을 우클릭 → 열기, 또는 xattr -dr com.apple.quarantine /Applications/Markdown\ Studio.app.
Linux에서 글자가 네모(□)로 보이면 시스템에 CJK 글꼴이 없는 것입니다. 앱은 글꼴을 내장하지 않고 시스템 것을 씁니다 — 16MB짜리 한중일 글꼴을 모든 사용자에게 강요하지 않으려는 선택입니다. deb/rpm은 이를 권장 의존성으로 걸어 두므로 보통 자동으로 따라옵니다. AppImage나 최소 설치라면 sudo apt install fonts-noto-cjk (또는 sudo dnf install google-noto-sans-cjk-fonts).
인터페이스는 한국어 · 영어 · 일본어 · 중국어(간체) · 스페인어 · 독일어 · 프랑스어를 지원하며, 기본은 기기의 언어 설정을 따릅니다. 설치마법사도 같습니다. 설정에서 직접 고를 수도 있습니다.
10 MB 문서에서 키 입력 1회가 52 ms, 1 MB에서 4.4 ms입니다. 파싱·개요·검사는 전부 UI 스레드 밖에서 디바운스와 취소를 걸어 돌아가므로 입력 자체는 막히지 않습니다.
빠른 이유는 네 가지입니다 — 문단 하나가 비주얼 하나, 뷰포트 밖은 실체화하지 않음, 편집 시 바뀐 영역만 재파싱, 열 때는 여러 코어 사용. 측정값과 남은 병목은 docs/PERFORMANCE.md에 있습니다.
CommonMark 0.31.2 스펙 스위트를 CI에서 돌립니다. 결과와 알려진 차이는 docs/TESTING.md를 보세요.
.NET 10 SDK가 있으면 됩니다.
git clone https://github.com/neramc/markdown.git
cd markdown
dotnet build
dotnet test
dotnet run --project src/MarkdownStudio.UI배포본 만들기, 플랫폼별 요구 사항, 벤치마크 실행은 docs/BUILDING.md.
src/
MarkdownStudio.Text 문자열·롭·문서 저장소
MarkdownStudio.Markdown 파서, 증분 분석, 개요, 검사
MarkdownStudio.Typesetting 수식 조판
MarkdownStudio.Rendering 네이티브 미리보기 렌더러
MarkdownStudio.Editing 편집 명령, Vim 엔진
MarkdownStudio.Workspace 설정, 세션, 파일 감시
MarkdownStudio.Updates 업데이트 확인과 적용
MarkdownStudio.UI Avalonia 셸 — 유일하게 모든 계층을 참조
MarkdownStudio.Installer.* Windows 설치마법사와 그 런처
계층 간 참조 방향은 리뷰가 아니라 빌드가 강제합니다 — tests/MarkdownStudio.Architecture.Tests를 보세요. 왜 그렇게 나눴는지는 docs/ARCHITECTURE.md에 있습니다.
CONTRIBUTING.md를 읽어 주세요. 보안 문제는 공개 이슈 대신 SECURITY.md의 절차를 따라 주시기 바랍니다.
GNU General Public License v3.0 이상.
이 프로그램은 자유 소프트웨어입니다. 어떠한 보증도 하지 않으며, GPL 제3판 이상의 조건에 따라 자유롭게 재배포하거나 수정할 수 있습니다. 배포본을 받은 사람은 누구나 소스 코드를 받을 권리가 있습니다 — 소스는 이 저장소에 있습니다.
이전 Electron 구현은 old 브랜치에 보존되어 있습니다.
사용한 오픈소스 — Avalonia · AvaloniaEdit · Markdig · TextMateSharp · AngleSharp · SkiaSharp · CommunityToolkit.Mvvm