Mẫu hình Markdown Database: Biến thư mục tệp tin thành cơ sở dữ liệu

Hệ thống tệp tin của bạn vốn dĩ đã là một cơ sở dữ liệu, chỉ là hầu hết các công cụ không nhìn nhận nó theo cách đó. Mẫu hình Markdown Database khai thác chính insight này, biến một thư mục chứa các tệp Markdown thành một kho dữ liệu có cấu trúc, vừa linh hoạt như văn bản thuần, vừa mạnh mẽ như một database truyền thống. Bài viết này sẽ phân tích chi tiết mẫu hình hữu ích nhưng ít được khai thác này — từ vấn đề nó giải quyết, cách triển khai, cho đến những ứng dụng thực tế dành cho blogger và nhà phát triển Việt Nam.

Vấn đề: Sự lựa chọn sai lầm trong quản lý nội dung

Cách tiếp cận truyền thống trong quản lý nội dung thường buộc bạn phải chọn một trong hai hướng:

• Hướng CMS (Hệ quản trị nội dung): Bạn có dữ liệu có cấu trúc rõ ràng — trường dữ liệu, kiểu dữ liệu, khả năng truy vấn phức tạp. Nhưng đánh đổi là nội dung bị "nhốt" trong cơ sở dữ liệu độc quyền, phụ thuộc vào giao diện quản trị và bị ràng buộc bởi nền tảng cụ thể. Phần văn xuôi (prose) trở nên "hạng hai".
• Hướng Markdown thuần túy: Bạn có sự tự do tuyệt đối — văn bản thô, dễ dàng quản lý phiên bản bằng git, soạn thảo bằng bất kỳ trình soạn thảo nào, và có thể host ở bất kỳ đâu. Nhưng bạn đánh mất khả năng truy vấn dữ liệu: bạn không thể hỏi "cho tôi xem mọi thứ được gắn thẻ 'nghiên cứu' viết từ tháng Giêng", không thể lọc, sắp xếp hay tổng hợp. Bạn có tài liệu, chứ không có dữ liệu.

Mẫu hình Markdown Database giải quyết bài toán này, mang lại những gì tốt nhất của cả hai thế giới: tệp Markdown kèm siêu dữ liệu, giúp bạn sở hữu nội dung tuyệt đối, có văn bản tự do, và có siêu dữ liệu có cấu trúc.

Mẫu hình chi tiết

• Tên: Markdown Database Pattern
• Vấn đề: Bạn cần nội dung vừa là văn bản giàu định dạng (rich text) dễ đọc cho con người, vừa là dữ liệu có cấu trúc để truy vấn — mà không bị ràng buộc vào một nền tảng nào hay hy sinh sự đơn giản của các tệp tin thô.
• Giải pháp: Coi một tập hợp các tệp Markdown như một cơ sở dữ liệu. Mỗi tệp là một bản ghi (record). Các trường trong phần frontmatter là các cột (columns). Các thư mục là các nhóm tự nhiên — hay có thể hiểu là các bảng (tables). Các thẻ tag, liên kết nội bộ và tác vụ (tasks) nhúng trong thân tài liệu trở thành các mối quan hệ (relations) có thể truy vấn.

Ánh xạ cơ bản giữa hệ thống tệp tin và cơ sở dữ liệu:

Hệ thống tệp tin	Cơ sở dữ liệu
Tệp Markdown	Bản ghi (record)
Trường frontmatter	Cột (column)
Thư mục	Bảng (table)
Thẻ #tag	Quan hệ thẻ (tag relation)
Liên kết [[wikilink]]	Quan hệ liên kết (link relation)
Tác vụ - [ ]	Quan hệ tác vụ (task relation)

Hệ quả: Bạn có tính di động tuyệt đối (tệp thô có thể mang đi bất cứ đâu), kiểm soát phiên bản tốt (git hoạt động hoàn hảo trên văn bản thô), không phụ thuộc framework nào, và có khả năng truy vấn toàn diện trên tập hợp của mình. Bạn phải đánh đổi khả năng mở rộng (mẫu hình này không dành cho hàng triệu bản ghi) và các mối quan hệ dữ liệu phức tạp (không thể thay thế một hệ quản trị cơ sở dữ liệu quan hệ thực thụ). Đây là một cơ sở dữ liệu hạng nhẹ — mạnh mẽ trong phạm vi của nó, và thành thật về những giới hạn.

Ví dụ minh họa: Thư mục ghi chú phim

Giả sử bạn có một thư mục movies/ với các ghi chú về phim:

movies/
├── return-of-the-jedi.md
├── a-new-hope.md
└── the-empire-strikes-back.md

Mỗi tệp có cấu trúc như sau:

---
year: 1983
director: Richard Marquand
budget_m: 32.7
tags: [sci-fi, space-opera]
---

# Return of the Jedi

A long time ago in a galaxy far, far away...

Thư mục đó chính là một cơ sở dữ liệu. Bạn chỉ cần một công cụ để đọc "lớp cấu trúc" này. Ví dụ, dùng MarkdownDB để lập chỉ mục, bạn có thể truy vấn qua SQL:

SELECT * FROM files WHERE year < 1980;
SELECT * FROM files WHERE director = 'George Lucas';
SELECT * FROM file_tags WHERE tag = 'space-opera';

Điểm quan trọng là điều này hoàn toàn khả thi: hãy lập chỉ mục thư mục một lần, và lớp dữ liệu có cấu trúc sẽ hiện ra. Phần văn xuôi vẫn là văn xuôi — dễ đọc, dễ viết trong bất kỳ trình soạn thảo nào, lưu trữ trong git. Bạn không còn phải chọn lựa.

Nhìn mà không cần code

SQL là một cách truy cập. Cách thân thiện hơn nhiều: hãy mở cùng thư mục đó trong Obsidian và sử dụng tính năng Base. Các trường frontmatter sẽ tự động hiển thị thành một bảng có thể sắp xếp và lọc, không cần biết bất kỳ ngôn ngữ truy vấn nào.

Ví dụ bảng dữ liệu từ Markdown trong Obsidian

Trong ảnh trên là một tập hợp các tệp nhân vật (character files) được hiển thị dưới dạng bảng. Các hướng dẫn thực hành sẽ bao gồm các công cụ; bạn có thể xây dựng một cơ sở dữ liệu Markdown từ một thư mục trống trong khoảng 20 phút.

Ứng dụng thực tế của mẫu hình

Một khi bạn hiểu và đặt tên được mẫu hình này, bạn sẽ bắt đầu thấy nó xuất hiện ở khắp mọi nơi:

• Một thư mục ghi chú cá nhân với frontmatter là một Markdown Database.
• Một wiki của nhóm mà mỗi trang đều có trường trạng thái và người phụ trách là một Markdown Database.
• Một blog nơi các bài viết mang siêu dữ liệu về ngày tháng, thẻ tag và tác giả cũng là một Markdown Database — chỉ là nó có thể chưa tự nhận thức được điều đó.

Mẫu hình này phù hợp tự nhiên với những nơi mà mỗi bản ghi đều có cả phần văn xuôi lẫn phần dữ liệu:

• Blog và bài viết
• Hệ thống tri thức cá nhân (Personal knowledge bases) và khu vườn số (digital gardens)
• Wiki nội bộ cho nhóm và tài liệu kỹ thuật
• Ghi chú nghiên cứu và danh sách đọc
• Bộ sưu tập công thức nấu ăn, nhật ký du lịch, tổng kết dự án

Điểm ngọt (sweet spot) của mẫu hình này là các bộ sưu tập có kích thước lên tới khoảng mười nghìn tệp tin. Vượt qua con số đó, bạn nên sử dụng một cơ sở dữ liệu thực thụ. Dưới mức đó, mẫu hình này mang lại gần như mọi thứ mà một database có thể làm, chỉ với một phần nhỏ độ phức tạp — và hoàn toàn không bị khóa vào một nền tảng cụ thể.

Triển khai mẫu hình

Bạn hoàn toàn có thể tự triển khai mẫu hình này với một lượng code đáng ngạc nhiên là rất ít. Quy trình cơ bản bao gồm: phân tích cú pháp frontmatter, duyệt cây thư mục, và ghi kết quả vào SQLite. Một dự án cuối tuần là hoàn toàn khả thi.

Hoặc bạn có thể sử dụng một công cụ đã được xây dựng sẵn. MarkdownDB có thể lập chỉ mục một thư mục chứa các tệp Markdown vào SQLite, trích xuất frontmatter, thẻ tag, liên kết và tác vụ, sau đó cung cấp một API JavaScript để truy vấn kết quả. Từ các tệp văn bản thuần túy, bạn có một cơ sở dữ liệu thực sự có thể truy vấn trong vài giây — mà không cần từ bỏ chính các tệp tin đó.

Mẫu hình có trước các công cụ

Điều quan trọng ở đây không phải là bất kỳ một triển khai cụ thể nào. Mà chính là mẫu hình — sự nhận thức rằng các tệp Markdown có một lớp cấu trúc đang chờ được sử dụng, và việc coi chúng như các bản ghi trong cơ sở dữ liệu là một lựa chọn thiết kế hợp lệ, mạnh mẽ và còn ít được khám phá.

Văn bản thuần túy có một tương lai dài. Markdown hiện diện ở khắp nơi. Dữ liệu vốn đã luôn ở đó.

Bạn chỉ cần một cái tên cho nó mà thôi.