MarkFlow를 만든 이유: 개발자의 일기

저는 아직도 그 화요일 밤을 기억합니다. 밤 11시였고, 저는 막 새 API에 대한 기술 문서를 마친 참이었습니다.

내용은 훌륭했습니다. Markdown으로 작성되었으며, 깔끔한 구조, 완벽한 코드 블록, 데이터 흐름을 설명하는 유효한 Mermaid 다이어그램이 있었습니다. README.md가 완벽하게 다듬어졌을 때 모든 개발자가 느끼는 그 만족감을 느꼈습니다.

그때 프로젝트 관리자로부터 Slack 알림이 떴습니다.

"이봐, 문서 작업 수고했어. 이걸 Word 문서로 보내줄 수 있어? 법무팀이 '변경 내용 추적'을 켜고 검토해야 하는데, 그들은 Markdown을 쓰지 않거든."

저는 한숨을 쉬었습니다. "물론이죠, 5분만 주세요."

유명한 마지막 말들이었죠.

"5분"의 악몽

저는 터미널을 열고 빠른 Pandoc 명령을 실행했습니다. pandoc docs.md -o docs.docx

Word에서 결과를 열었습니다. 심장이 쿵 내려앉았습니다.

• 표가 깨졌습니다. 열은 찌그러졌고 헤더는 정렬이 맞지 않았습니다.
• 다이어그램이 사라졌습니다. 제 아름다운 Mermaid 차트는 그저 벌거벗은 코드 블록일 뿐이었습니다.
• 구문 강조가 사라졌습니다. Python 코드는 읽기 어려운 일반 텍스트처럼 보였습니다.

"좋아,"라고 생각했습니다. "온라인 변환기를 써보자."

Google에서 "Markdown to Word converter"를 검색하고 첫 번째 결과를 클릭했습니다. 파일을 업로드하라고 요청했습니다. 저는 멈췄습니다. 이 문서에는 내부 API 엔드포인트와 독점 로직이 포함되어 있었습니다. 명확한 개인 정보 보호 정책이 없는 무작위 서버에 이것을 업로드할 방법은 없었습니다.

그래서 저는 절박한 개발자라면 누구나 할 법한 일을 했습니다. 한 화면에는 Word를, 다른 화면에는 VS Code를 열고 복사 붙여넣기를 시작했습니다.

저는 다음 두 시간을 수동으로 목록을 들여쓰고, 다이어그램의 스크린샷을 찍어 이미지로 붙여넣고, 굵게 스타일을 다시 적용하는 데 보냈습니다. 새벽 1시쯤 되자 저는 지치고 좌절했습니다. 저는 코딩을 하는 게 아니었습니다. 워드 프로세서와 싸우고 있었습니다.

깨달음

그날 밤, 저는 두 가지를 깨달았습니다.

1. Markdown은 글쓰기에는 좋지만, 세상은 Word로 돌아간다. 우리는 그것을 피할 수 없습니다.
2. 기존 도구는 선택을 강요합니다. Pandoc과 같은 CLI 도구를 구성하는 데 시간을 보내거나 클라우드 변환기에 개인 정보를 희생하거나.

저는 어느 쪽도 원하지 않았습니다. 저는 내 개인 정보를 존중하고(로컬 처리) 내 서식을 존중하는(GFM 지원) 도구를 원했습니다.

그래서 저는 MarkFlow를 만들었습니다.

저 자신(그리고 당신)을 위해 만들기

저는 제 자신의 사용을 위한 작은 유틸리티로 MarkFlow를 만들기 시작했습니다. 목표는 간단했습니다.

• 로컬이어야 한다. 데이터가 브라우저를 떠나지 않고 기밀 계약서나 방대한 문서를 변환하고 싶습니다.
• "까다로운" 것을 처리해야 한다. 표, 작업 목록, 그리고 물론 코드 블록에 대한 구문 강조.
• 빨라야 한다. 드래그, 드롭, 완료.

첫 번째 버전을 동료에게 보여주었을 때, 그녀의 눈이 반짝였습니다. "잠깐, 표 서식을 유지한다고? 그리고 Python을 설치할 필요가 없어?"

그때 저는 이것이 제 노트북에 있는 스크립트로만 남아서는 안 된다는 것을 알았습니다.

왜 "로컬 우선(Local-First)"이 중요한가

2026년에 데이터 개인 정보 보호는 사치가 아닙니다. 필수 사항입니다. 저는 변환 엔진이 웹 브라우저 내부에서 직접 실행되는 고유한 아키텍처로 MarkFlow를 구축했습니다.

MarkFlow를 사용할 때 파일을 저에게 보내는 것이 아닙니다. 본질적으로 웹사이트에 있는 강력한 앱을 사용하는 것입니다. 즉, 데이터 유출의 두려움 없이 NDA, 특허 초안, 개인 일기를 변환할 수 있습니다.

내 좌절에서 당신의 생산성으로

오늘날 MarkFlow는 그 심야의 좌절에서 수천 명의 사용자가 신뢰하는 강력한 도구로 성장했습니다.

• 더 이상 깨진 표는 없습니다.
• 더 이상 누락된 코드 색상은 없습니다.
• 더 이상 개인 정보 보호에 대한 불안은 없습니다.

저는 당신이 화요일 밤을 Word 서식과 싸우느라 보내지 않도록 이것을 만들었습니다. 콘텐츠에 집중하세요. 프레젠테이션은 MarkFlow에 맡기십시오.

최신 .md 파일로 시도해 보세요. 제가 결코 되돌릴 수 없는 그 두 시간을 당신이 절약할 수 있기를 바랍니다.

— MarkFlow 개발자