본문으로 건너뛰기
J
피드

AI 코딩 에이전트만으로 만든 네이티브 맥용 마크다운 뷰어

open-source 약 6분
tags
#tauri#rust#markdown#macos#ai-coding
vote
0
댓글
북마크

한 개발자가 네이티브 macOS 마크다운 뷰어를 공개했는데, 흥미로운 포인트는 앱 자체보다 구현 방식이다. Rust, Tauri 2, pulldown-cmark, ammonia, KaTeX, Mermaid.js를 조합했고, 초기 구현부터 후속 리팩터링까지 AI 코딩 에이전트가 전부 맡았다고 밝힌다.

  • 1

    GitHub Flavored Markdown, Obsidian 스타일 위키링크, 콜아웃, 수식, Mermaid 다이어그램을 지원한다

  • 2

    HTML은 ammonia로 정리해 기본적으로 XSS에 안전하게 만들었다

  • 3

    초기 구현은 로컬 llama.cpp 기반 Qwen3.6 모델이, 후속 수정은 Claude Code가 담당했다

  • 4

    작성자는 사람 손으로 코드를 직접 치지 않고 제품 수준 앱을 만들었다고 주장한다

  • macOS용 네이티브 마크다운 뷰어가 Show HN에 올라왔는데, 포인트는 기능보다 'AI 코딩 에이전트 100%'라는 제작 방식임

    • 앱 이름은 Markdown Viewer고, Apple Silicon용 .dmg로 배포됨
    • 작성자는 Rust, CSS, JavaScript까지 초기 구현의 모든 줄을 사람이 직접 치지 않았다고 설명함
    • 초기 구현은 로컬 llama.cpp에서 돌린 Qwen3.6-35B-A3B-GGUF:BF16 모델이 맡았고, 이후 수정과 아키텍처 작업은 Claude Code가 했다고 함

  • 기능 자체도 그냥 README 뷰어 수준은 아님

    • GitHub Flavored Markdown의 표, 체크리스트, 취소선, 자동 링크, fenced code block을 지원함
    • Obsidian 스타일의 [[Page|label]] 위키링크, 이모지 shortcode, 콜아웃도 처리함
    • 수식은 KaTeX로, 다이어그램은 Mermaid.js로 렌더링함
    • frontmatter는 제목, 설명, 태그, 상태 배지, 전체 메타데이터 패널로 보여줌

❗중요

> 이 프로젝트의 가장 센 부분은 'AI가 샘플 코드를 짰다'가 아니라, 설치 파일 배포와 macOS 파일 연결, 릴리스 자동화까지 포함한 앱 형태로 정리됐다는 점임.

  • 보안 쪽도 최소한의 방어선은 잡아놨음

    • 마크다운에서 나온 HTML은 Rust 라이브러리 ammonia로 sanitize한다고 밝힘
    • 외부 .md, .markdown, .txt 파일을 여는 뷰어 특성상 XSS 방어는 꽤 중요한 부분임
    • README는 'XSS-safe by default'라고 표현하지만, 실제 보안성은 허용 태그 정책과 렌더링 파이프라인을 봐야 정확히 판단 가능함

  • 구조는 Tauri 2.x 기반의 Rust 백엔드 + 웹 렌더링 조합임

    • Markdown 파싱은 pulldown-cmark가 담당함
    • 텍스트 전처리는 regex, HTML 정리는 ammonia가 맡음
    • 렌더링 쪽에서는 Webview 위에서 HTML/CSS/JS, KaTeX, Mermaid.js가 움직임
    • 작성자는 '웹뷰 오버헤드 없음'이라고 적었지만, 구조 설명에는 Webview가 들어가 있어서 표현은 약간 애매함. 아마 Electron식 무거운 런타임이 없다는 의미에 가까워 보임

  • macOS 앱으로서의 디테일도 꽤 챙겼음

    • Finder에서 .md, .markdown, .txt 파일을 더블클릭하면 앱으로 열리도록 파일 연결을 등록함
    • 앱 아이콘으로 드래그 앤 드롭해서 열 수 있고, 사이드바로 파일 간 이동도 가능함
    • 첫 실행 때 macOS quarantine 때문에 '앱이 손상됨' 경고가 뜰 수 있어서 xattr -cr로 지우는 안내도 있음

  • AI 코딩 사례로 보면 꽤 현실적인 조합이 흥미로움

    • 로컬 모델이 초기 제품을 만들고, Claude Code가 Tauri 2.x 마이그레이션 정리, macOS 파일 열기 deadlock 조사, frontmatter 렌더링 재설계 같은 후속 작업을 맡았다고 함
    • 즉 '한 번에 완성'보다는 AI 에이전트를 이어 붙여 제품을 다듬은 케이스에 가까움
    • 작성자는 무분별한 AI 생성 PR은 권장하지 않는다고 적었는데, 이 대목이 은근 현실적임

기술 맥락

  • 이 앱의 선택은 '마크다운을 예쁘게 보여주는 데스크톱 앱'을 만들면서 Electron 대신 Tauri 2를 고른 쪽에 가까워요. macOS에서 가볍게 뜨고 바이너리를 작게 유지하려면, 무거운 런타임을 통째로 싣는 방식보다 Rust 백엔드와 시스템 웹뷰 조합이 유리하거든요.

  • Markdown 파싱을 pulldown-cmark에 맡긴 것도 자연스러운 선택이에요. Rust 앱 안에서 마크다운을 처리해야 하니, 파서부터 렌더링 전처리까지 같은 생태계에서 가져가면 배포와 성능 관리가 단순해져요.

  • ammonia를 넣은 이유는 꽤 중요해요. 마크다운 뷰어는 사용자가 만든 문서만 여는 것 같아도, 실제로는 인터넷에서 받은 README나 노트 파일을 그대로 열 수 있거든요. HTML을 렌더링하는 순간 XSS 같은 문제가 생길 수 있어서, 렌더링 전에 정리하는 단계가 필요해요.

  • KaTeX와 Mermaid.js는 개발자 문서용 뷰어라는 포지션을 강화해요. 요즘 README나 설계 문서에는 수식, 시퀀스 다이어그램, 상태 다이어그램이 섞이는 경우가 많아서, 단순 텍스트 뷰어로는 부족하거든요.

이건 단순한 Show HN 앱 소개라기보다, AI 코딩 에이전트가 이제 데모를 넘어 배포 가능한 데스크톱 앱까지 밀어붙일 수 있다는 사례에 가깝다. 다만 README 자체가 제품 설명과 제작 일화를 섞고 있어서, 실제 품질 판단은 코드와 이슈를 같이 봐야 한다.

prev

이전 기사 (P)

next

다음 기사 (N)

댓글

댓글

댓글을 불러오는 중...

관련 기사

open-source

NIPA, 260명 규모 오픈소스 컨트리뷰션 아카데미 시작

정보통신산업진흥원이 2026 오픈소스 컨트리뷰션 아카데미 발대식을 열고 13주간의 프로젝트 활동을 시작했음. 국내 개발자들이 GitHub 기반 글로벌 협업 환경에서 코드, 문서, 버그 수정, 풀 리퀘스트를 직접 경험하게 하는 프로그램임.

open-source

그누보드7, 디딤과 손잡고 멀티클라우드 도입 문턱 낮춘다

에스아이알소프트가 클라우드 전문기업 디딤과 협력해 그누보드7 기반 웹서비스 구축·운영 환경을 넓히기로 했다. 커뮤니티, 쇼핑몰, 예약, 구독형 서비스 같은 실무 프로젝트에서 서버 구성과 운영 부담을 줄이는 게 핵심이다.

open-source

오픈소스 컨트리뷰션 아카데미 출범, 국내 개발자 260여 명 참여

정보통신산업진흥원이 2026 오픈소스 컨트리뷰션 아카데미 발대식을 열고 13주간의 활동을 시작했다. 11개 프로젝트팀의 멘토와 멘티 260여 명이 글로벌 오픈소스 프로젝트 기여를 목표로 코드 개발, 문서화, 오류 수정 등을 진행한다.

open-source

NIPA, 국내 개발자 260명 규모 오픈소스 컨트리뷰션 아카데미 시작

정보통신산업진흥원이 2026 오픈소스 컨트리뷰션 아카데미 발대식을 열고 국내 개발자의 글로벌 오픈소스 프로젝트 참여를 지원한다. 11개 프로젝트팀, 멘토·멘티 260여 명이 13주 동안 깃허브 기반 협업, 코드 리뷰, 문서화, 오류 수정 등을 실제로 경험한다.

open-source

Ghostty 엔진을 Emacs 안으로 끌고 온 터미널, Ghostel.el

Ghostel.el은 Ghostty의 libghostty-vt를 기반으로 Emacs 안에서 동작하는 터미널 에뮬레이터다. eat 스타일의 여러 입력 모드, 안정적인 복사 모드, line mode, 자동 password prompt 처리, compile-mode 유사 실행 버퍼, Kitty graphics 지원, 높은 throughput을 앞세워 eat/vterm과 차별화함.