Tại sao tôi tạo ra MarkFlow: Nhật ký của một lập trình viên

Tôi vẫn nhớ buổi tối thứ Ba hôm đó. Lúc đó là 11 giờ đêm, và tôi vừa hoàn thành tài liệu kỹ thuật cho API mới của chúng tôi.

Nội dung thật đẹp — được viết bằng Markdown, với cấu trúc rõ ràng, các khối mã hoàn hảo và sơ đồ Mermaid hợp lệ giải thích luồng dữ liệu. Tôi cảm thấy mãn nguyện như mọi lập trình viên đều biết khi tệp README.md được trau chuốt đến mức hoàn hảo.

Sau đó, một thông báo Slack hiện lên từ người quản lý dự án của tôi:

“Này, làm tài liệu tốt lắm. Bạn có thể gửi cho tôi dưới dạng tài liệu Word không? Nhóm pháp lý cần xem xét nó với chế độ 'Theo dõi thay đổi' được bật, và họ không sử dụng Markdown.”

Tôi thở dài. "Chắc chắn rồi, cho tôi năm phút."

Những lời cuối cùng nổi tiếng.

Cơn ác mộng “năm phút”

Tôi mở terminal và chạy nhanh lệnh Pandoc. pandoc docs.md -o docs.docx

Tôi mở kết quả trong Word. Tim tôi thắt lại.

• Các bảng bị vỡ. Các cột bị bẹp dúm, và tiêu đề bị lệch.
• Các sơ đồ đã biến mất. Các biểu đồ Mermaid đẹp đẽ của tôi chỉ còn là những khối mã trần trụi.
• Tô sáng cú pháp đã biến mất. Mã Python trông giống như văn bản thuần túy, khó đọc.

"Được rồi," tôi nghĩ. "Tôi sẽ thử một trình chuyển đổi trực tuyến."

Tôi Google “Markdown to Word converter” và nhấp vào kết quả đầu tiên. Nó yêu cầu tôi tải lên tệp của mình. Tôi dừng lại. Tài liệu này chứa các điểm cuối API nội bộ và logic độc quyền. Không đời nào tôi lại tải cái này lên một máy chủ ngẫu nhiên nào đó mà không có chính sách quyền riêng tư rõ ràng.

Vì vậy, tôi đã làm điều mà bất kỳ lập trình viên tuyệt vọng nào cũng sẽ làm. Tôi mở Word trên một màn hình, VS Code trên màn hình kia, và bắt đầu sao chép-dán.

Tôi đã dành hai giờ tiếp theo để thụt lề thủ công các danh sách, chụp ảnh màn hình các sơ đồ của mình để dán chúng dưới dạng hình ảnh, và áp dụng lại các kiểu in đậm. Đến 1 giờ sáng, tôi kiệt sức và thất vọng. Tôi không phải đang viết mã; tôi đang chiến đấu với một trình xử lý văn bản.

Sự nhận thức

Đêm đó, tôi nhận ra hai điều:

1. Markdown rất tuyệt để viết, nhưng thế giới vận hành trên Word. Chúng ta không thể trốn thoát nó.
2. Các công cụ hiện có buộc bạn phải lựa chọn: hoặc dành hàng giờ để cấu hình các công cụ CLI như Pandoc, hoặc hy sinh quyền riêng tư của bạn cho các trình chuyển đổi đám mây.

Tôi không muốn cả hai. Tôi muốn một công cụ tôn trọng quyền riêng tư của tôi (xử lý cục bộ) và tôn trọng định dạng của tôi (hỗ trợ GFM).

Vì vậy, tôi đã xây dựng MarkFlow.

Xây dựng nó cho chính tôi (và bạn)

Tôi bắt đầu xây dựng MarkFlow như một tiện ích nhỏ cho mục đích sử dụng của riêng mình. Mục tiêu rất đơn giản:

• Nó phải là cục bộ. Tôi muốn chuyển đổi các hợp đồng nhạy cảm hoặc tài liệu phong phú mà dữ liệu không bao giờ rời khỏi trình duyệt của tôi.
• Nó phải xử lý được những thứ “khó nhằn”. Bảng, danh sách công việc, và vâng, tô sáng cú pháp cho các khối mã.
• Nó phải nhanh. Kéo, thả, xong.

Khi tôi cho đồng nghiệp xem phiên bản đầu tiên, mắt cô ấy sáng lên. "Khoan đã, nó giữ nguyên định dạng bảng à? Và tôi không cần cài đặt Python sao?"

Đó là lúc tôi biết điều này không nên chỉ là một tập lệnh trên máy tính xách tay của mình.

Tại sao “Ưu tiên cục bộ” lại quan trọng với tôi

Vào năm 2026, quyền riêng tư dữ liệu không phải là một sự xa xỉ; đó là một yêu cầu. Tôi đã xây dựng MarkFlow với một kiến trúc độc đáo, nơi công cụ chuyển đổi chạy trực tiếp trong trình duyệt web của bạn.

Khi bạn sử dụng MarkFlow, bạn không gửi tệp của mình cho tôi. Về cơ bản, bạn đang sử dụng một ứng dụng mạnh mẽ tình cờ "sống" trên một trang web. Điều này có nghĩa là bạn có thể chuyển đổi NDA, bản thảo bằng sáng chế và nhật ký riêng tư của mình mà không sợ rò rỉ dữ liệu.

Từ sự thất vọng của tôi đến năng suất của bạn

Ngày nay, MarkFlow đã phát triển từ sự thất vọng đêm khuya đó thành một công cụ mạnh mẽ được hàng nghìn người dùng tin cậy.

• Không còn bảng bị vỡ.
• Không còn thiếu màu mã.
• Không còn lo lắng về quyền riêng tư.

Tôi xây dựng cái này để bạn không bao giờ phải dành tối thứ Ba của mình để chiến đấu với định dạng Word. Hãy tập trung vào nội dung; để MarkFlow lo phần trình bày.

Hãy thử nó với tệp .md mới nhất của bạn. Tôi hy vọng nó sẽ giúp bạn tiết kiệm hai giờ mà tôi sẽ không bao giờ lấy lại được.

— Nhà phát triển MarkFlow