Sotaythuthuat.com luôn tìm kiếm những giải pháp công nghệ tiên tiến, và hôm nay, chúng ta sẽ khám phá cách chuyển đổi một bộ ghi chú cá nhân mạnh mẽ thành một nguồn thông tin công khai hữu ích. Obsidian, với khả năng tạo dựng cơ sở tri thức cá nhân dựa trên Markdown, đã trở thành công cụ không thể thiếu của nhiều người dùng để phác thảo ý tưởng, viết bài, và lưu trữ tài liệu tham khảo. Với cấu trúc liên kết nội bộ chặt chẽ và khả năng tổ chức linh hoạt, Obsidian giúp mọi suy nghĩ, thông tin được kết nối mạch lạc.
Tuy nhiên, sau nhiều tháng xây dựng một kho lưu trữ Obsidian (Obsidian Vault) đồ sộ, một nhu cầu chung thường nảy sinh là mong muốn chia sẻ một phần kiến thức đó ra bên ngoài, hoặc đơn giản là truy cập các ghi chú quan trọng từ bất cứ đâu mà không cần mở ứng dụng Obsidian. Vấn đề đặt ra là việc xuất bản các tệp Markdown này thành một trang web sạch sẽ, dễ điều hướng dường như phức tạp hơn mong đợi. May mắn thay, trong quá trình tìm kiếm một công cụ để lưu trữ Obsidian Vault trên internet, Quartz đã xuất hiện và thay đổi hoàn toàn cục diện.
Quartz là gì? Công cụ lý tưởng cho người dùng Obsidian
Quartz là một công cụ tạo trang web tĩnh (static site generator) mã nguồn mở, được thiết kế đặc biệt để xuất bản các tệp Markdown. Điều làm cho Quartz trở nên nổi bật là nó được cập nhật thường xuyên và đặc biệt “hiểu” cách các công cụ Markdown như Obsidian hoạt động – bao gồm các liên kết ngược (backlinks), cấu trúc thư mục, front matter và nhiều tính năng khác.
Không giống như các giải pháp khác cố gắng ép buộc ghi chú của bạn vào cấu trúc riêng của chúng, Quartz linh hoạt thích nghi với cách bạn đã tổ chức mọi thứ. Nó không thay thế Obsidian mà thực sự bổ trợ cho Obsidian. Bạn vẫn viết và tổ chức ghi chú trong Obsidian như bình thường, sau đó sử dụng Quartz để biến chúng thành một trang web công cộng với giao diện đẹp mắt và chức năng hiệu quả. Không còn lo lắng về các liên kết bị hỏng, không cần chuyển đổi thủ công hay phải vật lộn với HTML hoặc CSS, trừ khi bạn muốn tùy chỉnh sâu hơn.
Tại sao Quartz vượt trội? Các tính năng nổi bật
Ngoài Quartz, có một số công cụ tạo trang web tĩnh khác. Tuy nhiên, dưới đây là những lý do chính khiến Quartz trở thành lựa chọn hàng đầu cho việc xuất bản Obsidian Vault:
Tối ưu hóa cho người dùng Obsidian
Quartz được xây dựng để tương thích hoàn hảo với cách Obsidian xử lý ghi chú. Nó không yêu cầu bạn phải làm phẳng cấu trúc thư mục hay định dạng lại các tệp Markdown. Các liên kết ngược hoạt động chính xác, các liên kết nội bộ được giải quyết, và cấu trúc trực quan của Vault vẫn được bảo toàn. Ngay cả phương pháp Zettelkasten, nếu bạn sử dụng, cũng được Quartz giữ nguyên, đảm bảo tính nhất quán giữa Vault và trang web của bạn.
Tùy chỉnh dễ dàng, không cần code
Bạn không cần phải chạm vào CSS hay HTML để cá nhân hóa trang web của mình. Hầu hết các thay đổi – như tiêu đề trang web, mô tả, bố cục trang chủ, hoặc khả năng hiển thị – đều được quản lý thông qua một tệp quartz.config.ts đơn giản. Muốn thay đổi giao diện (theme) hoặc ẩn một số trang nhất định? Chỉ cần bật/tắt một tùy chọn. Quartz cũng hỗ trợ các kiểm soát dựa trên Markdown, ví dụ như draft: true trong front matter, giúp bạn quản lý khả năng hiển thị của ghi chú mà không cần chỉnh sửa sâu vào cấu hình.
Tốc độ và quyền riêng tư cao
Quartz tạo ra các tệp tĩnh, giúp trang web cuối cùng cực kỳ nhanh và dễ dàng lưu trữ. Bạn có thể sử dụng GitHub Pages như chúng tôi đã làm, hoặc các dịch vụ khác như Netlify đều hoạt động rất tốt. Vì không phụ thuộc vào các công cụ phân tích bên thứ ba hay quảng cáo nhúng, các ghi chú đã xuất bản của bạn vẫn nhẹ và riêng tư. Bạn thậm chí có thể chạy toàn bộ hệ thống cục bộ nếu chỉ muốn truy cập ghi chú từ xa qua mạng cục bộ (LAN).
Điều hướng thông minh, tìm kiếm tích hợp
Một trong những tính năng tuyệt vời nhất là Quartz tự động tạo ra một cấu trúc điều hướng toàn diện từ các thư mục và tệp của bạn. Nó cũng hỗ trợ thẻ (tags), liên kết ngược và chức năng tìm kiếm tự nhiên mà không yêu cầu các dịch vụ bên thứ ba. Quartz tôn trọng phong cách gắn thẻ của Obsidian, đảm bảo mọi thứ vẫn nhất quán với cấu trúc nội bộ của Vault.
Hướng dẫn thiết lập Quartz chi tiết từng bước
Việc thiết lập Quartz ban đầu có thể không hoàn toàn đơn giản, nhưng nếu bạn cẩn thận làm theo các bước dưới đây, quá trình này sẽ chỉ mất chưa đến 15 phút.
Bước 1: Kiểm tra các yêu cầu tiền đề
Trước khi tiến hành thiết lập Quartz để biến Obsidian Vault thành một trang web, bạn cần đảm bảo hệ thống của mình đã cài đặt các công cụ cần thiết sau:
- Node.js: Phiên bản 20 trở lên. Bạn có thể kiểm tra bằng lệnh
node -v. - npm: Phiên bản 9.3.1 trở lên. Kiểm tra bằng lệnh
npm -v. - Git: Đảm bảo Git đã được cài đặt và cấu hình đúng.
Nếu bạn đang sử dụng một trình quản lý phiên bản như nvm, hãy đảm bảo rằng phiên bản Node.js chính xác đang được kích hoạt.
Kiểm tra phiên bản Node.js, npm và Git trên Command Prompt để cài đặt Quartz
Bước 2: Clone và cài đặt Quartz
Bây giờ, hãy clone (tải về) kho lưu trữ Quartz từ GitHub của jackyzha0. Đồng thời, bạn cũng cần cài đặt các dependency (phụ thuộc). Để thực hiện, hãy mở Command Prompt với quyền quản trị và sử dụng các lệnh sau:
git clone https://github.com/jackyzha0/quartz.git Quartzcd Quartznpm installnpx quartz create
Trong lệnh đầu tiên, “Quartz” là tên của thư mục trên máy tính của bạn nơi bạn muốn sao chép kho lưu trữ. Trong quá trình chạy npx quartz create, hãy chọn các tùy chọn phù hợp với sở thích của bạn. Nếu không có lựa chọn cụ thể, hãy chọn các tùy chọn mặc định.
Thực hiện lệnh git clone để tải kho lưu trữ Quartz từ GitHub
Bước 3: Tích hợp Obsidian Vault của bạn
Tiếp theo, thông qua File Explorer, bạn mở thư mục chứa Obsidian Vault mà bạn muốn xuất bản lên internet. Sao chép tất cả các tệp Markdown (.md) từ Vault đó và dán chúng vào thư mục Content của thư mục dự án Quartz của bạn (trong trường hợp của chúng tôi, thư mục dự án được đặt tên là Quartz).
Sao chép các tệp Markdown từ Obsidian Vault vào thư mục Content của dự án Quartz
Bước 4: Xem trước trang web cục bộ
Trước khi triển khai trang web, bạn nên xem trước nó cục bộ để kiểm tra giao diện và phát hiện bất kỳ vấn đề nào. Để làm điều này, hãy mở Command Prompt và sử dụng lệnh cd để điều hướng đến thư mục dự án của bạn (Quartz trong trường hợp này). Sau đó, sử dụng lệnh này để khởi động một máy chủ cục bộ: npx quartz build --serve
Sau khi chạy lệnh mà không có lỗi, hãy truy cập http://localhost:8080 trong trình duyệt của bạn để xem trang web.
Xem trước trang web Quartz được tạo từ ghi chú Obsidian trên trình duyệt cục bộ
Bước 5: Cấu hình kho lưu trữ GitHub (Repository)
Tiếp theo, bạn cần tạo và cấu hình một kho lưu trữ GitHub để triển khai các tệp Markdown của Obsidian. Để làm điều đó, hãy mở Command Prompt và điều hướng đến thư mục dự án bằng lệnh cd. Sau đó, thực hiện các tác vụ sau:
- Khởi tạo Git:
git init - Thêm Remote: Thêm kho lưu trữ GitHub của bạn làm nguồn từ xa:
git remote add origin https://github.com/TenGitHubCuaBan/ten-repo-cua-ban.git(thay thếTenGitHubCuaBanvàten-repo-cua-banbằng thông tin của bạn). - Commit Thay đổi: Commit các thay đổi của bạn:
git add .git commit -m "First Commit"
Cấu hình repository GitHub với các lệnh git init và git remote add để chuẩn bị triển khai Quartz
Bước 6: Thiết lập GitHub Actions để triển khai (Deployment)
Sau đó, hãy mở thư mục dự án của bạn qua File Explorer và điều hướng đến vị trí: .github > workflows. Tại đây, tạo một tệp văn bản mới và đặt tên là deploy.yml. Sau đó, sao chép và dán nội dung sau vào tệp mới tạo này:
name: Deploy Quartz site to GitHub Pages
on:
push:
branches:
- v4 # Hoặc tên branch chính của bạn, ví dụ: main
permissions:
contents: read
pages: write
id-token: write
concurrency:
group: "pages"
cancel-in-progress: false
jobs:
build:
runs-on: ubuntu-22.04
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- uses: actions/setup-node@v4
with:
node-version: 22 # Đảm bảo phiên bản Node.js phù hợp
- name: Install Dependencies
run: npm install
- name: Build Quartz
run: npx quartz build
- name: Upload artifact
uses: actions/upload-pages-artifact@v3
with:
path: public
deploy:
needs: build
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4Đảm bảo rằng node-version trong tệp deploy.yml khớp với phiên bản bạn đang sử dụng cục bộ.
Tạo tệp deploy.yml trong thư mục .github/workflows để thiết lập GitHub Actions cho việc triển khai Quartz
Bước 7: Đẩy mã lên GitHub
Tiếp theo, hãy đẩy kho lưu trữ cục bộ của bạn lên GitHub. Để làm điều đó, bạn sử dụng lệnh này: git push -u origin v4
Ở đây, v4 là tên nhánh (branch). Nếu tên nhánh của bạn khác, ví dụ như main, hãy sử dụng nó trong lệnh. Lệnh này sẽ kích hoạt quy trình làm việc của GitHub Actions và triển khai trang web của bạn.
Bước 8: Cấu hình GitHub Pages
Đây là một bước quan trọng. Bạn cần cẩn thận cấu hình cài đặt GitHub Pages để trang web được phát trực tuyến thành công.
- Điều hướng đến Cài đặt: Mở kho lưu trữ Quartz của bạn trên GitHub và nhấp vào “Settings” (Cài đặt).
- Cài đặt Pages: Trong thanh bên, nhấp vào “Pages”.
- Nguồn (Source): Dưới phần “Build and deployment”, đảm bảo rằng “GitHub Actions” được chọn làm nguồn.
Chọn GitHub Actions làm nguồn triển khai trong cài đặt GitHub Pages cho website Obsidian Quartz
Bước 9: Truy cập trang web đã triển khai của bạn
Sau khi quy trình làm việc hoàn tất, trang web của bạn sẽ có sẵn tại địa chỉ: https://tennguoidunggithub.github.io/ten-repo-cua-ban/ (thay thế bằng tên người dùng và tên repo của bạn).
Ví dụ, với trường hợp trong bài gốc, địa chỉ là: https://pranav711.github.io/Quartz/
Trang web được tạo từ Obsidian Vault thông qua Quartz đã được triển khai thành công trên GitHub Pages
Bước 10: Tùy chỉnh trang web Obsidian Vault
Sau khi đã lưu trữ thành công Obsidian Vault của mình trên internet, bạn có thể tùy chỉnh thêm bằng cách chỉnh sửa tệp quartz.config.ts, tệp này nằm bên trong thư mục dự án của bạn trên PC (ví dụ: Quartz). Bạn cũng có thể sửa đổi nội dung trang chủ bằng cách chỉnh sửa tệp index.md nằm trong thư mục Content.
Hãy hết sức cẩn thận khi sửa đổi các tệp, vì một lỗi nhỏ cũng có thể dẫn đến lỗi 404. Ngoài ra, đừng quên đẩy (push) các thay đổi lên GitHub bằng lệnh git push sau mỗi lần chỉnh sửa để các thay đổi cục bộ được phản ánh trên trang web của bạn.
Tệp quartz.config.ts để tùy chỉnh cấu hình và giao diện cho trang web Quartz của bạn
Từ Vault riêng tư đến trang web công cộng: Quartz giúp mọi thứ trở nên liền mạch
Việc xuất bản Obsidian Vault ban đầu tưởng chừng là một nhiệm vụ nặng nề và đầy thử thách, nhưng Quartz đã biến nó thành một trải nghiệm dễ dàng đến bất ngờ. Công cụ này tôn trọng cấu trúc mà bạn đã xây dựng trong Obsidian, không yêu cầu bạn phải học một ngôn ngữ hoặc chuỗi công cụ mới, và cho phép bạn kiểm soát hoàn toàn những gì được xuất bản.
Việc có các ghi chú của mình dưới định dạng web giúp bạn nhìn rõ hơn các ý tưởng của mình. Trang web này có thể tìm kiếm, liên kết và dễ dàng duyệt qua. Hơn nữa, việc mọi thứ được xây dựng trên các tệp tĩnh đảm bảo bạn không bao giờ phải phụ thuộc vào máy chủ hoặc dịch vụ của người khác, mang lại sự an tâm về quyền sở hữu dữ liệu.
Quartz là một giải pháp tuyệt vời nếu bạn đã từng muốn biến các ghi chú Markdown của mình thành một trang web sạch sẽ, dễ điều hướng mà không phải tự xây dựng từ đầu. Nó nhanh, miễn phí, mã nguồn mở và được tạo ra bởi những người rõ ràng hiểu cách những người viết lách và ghi chú tư duy. Hãy thử Quartz – bạn có thể sẽ xuất bản nhiều hơn những gì mình dự định ban đầu đấy!
Nếu bạn gặp bất kỳ vấn đề nào trong quá trình thực hiện, đừng ngần ngại chia sẻ ý kiến hoặc câu hỏi của bạn trong phần bình luận bên dưới. Sotaythuthuat.com luôn sẵn lòng hỗ trợ bạn.
