본문으로 건너뛰기
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

위키피디아에도 빅테크식 반노조 플레이북이 들어왔다

위키미디어 재단이 5월 열흘 사이 MediaWiki 장기 핵심 개발자를 해고하고, 자원봉사 편집자 요청을 처리하던 Community Tech 팀을 해산했다는 비판 글이다. 해고된 인력 상당수가 노조 조직 활동과 연결돼 있었고, 위키피디아 편집자들은 연대 파업까지 거론하고 있다. 재단은 2억9660만 달러의 준비금과 빠르게 성장하는 AI 대상 API 매출을 갖고 있어, 이 사안이 단순 비용 절감으로 보기 어렵다는 게 글의 핵심이다.

open-source

캘리포니아, 연령 확인법에서 리눅스 빼려는 수정안 추진

캘리포니아가 운영체제에 사용자 나이 확인을 요구하는 법안에서 대부분의 오픈소스 운영체제를 제외하는 수정안을 추진 중이다. 데비안, 페도라, 우분투, 아치, 리눅스 민트 같은 배포판은 빠질 가능성이 커졌지만, 스팀OS처럼 독점 앱 생태계와 연결된 플랫폼은 여전히 애매한 상태다.

open-source

마이크로소프트, 45년 전 86-DOS 소스코드를 오픈소스로 공개

마이크로소프트가 86-DOS 1.00 출시 45주년에 맞춰 지금까지 발견된 것 중 가장 오래된 DOS 소스코드를 공개했어. 팀 패터슨의 차고에 있던 도트 매트릭스 출력물을 스캔하고 옮겨 적어, 원본 바이너리와 바이트 단위로 동일하게 다시 컴파일되는 수준까지 복원한 게 포인트야.

open-source

밤부 랩, AGPLv3 위반 논란으로 오픈소스 커뮤니티와 충돌

3D 프린터 제조사 밤부 랩이 AGPLv3 라이선스 위반 논란에 휘말렸고, Software Freedom Conservancy가 두 건의 위반 사례를 확인했다는 내용이야. Louis Rossmann과 Gamers Nexus는 관련 개발자의 법적 방어를 위해 2만달러를 기부했고, 갈등의 핵심은 오픈소스 기반 생태계를 클라우드와 DRM으로 점점 닫아가려는 움직임이야.

open-source

플리퍼, 리눅스 기반 확장형 기기 '플리퍼 원' 공개

플리퍼가 기존 플리퍼 제로를 대체하는 후속작이 아니라, 리눅스 기반 네트워킹·확장형 기기인 플리퍼 원을 공개했어. RK3576 8코어 ARM 칩, 와이파이 6E, 듀얼 이더넷, NVMe, HDMI 4K 120Hz까지 넣으면서 장난감 같은 해킹 도구에서 훨씬 범용적인 리눅스 장비 쪽으로 방향을 넓히는 그림이야.