Tôi đã sử dụng Obsidian một thời gian như một không gian để soạn thảo các bài viết của mình. Đây là một công cụ nhanh chóng, ưu tiên cục bộ và tôi rất thích cách nó cho phép tôi xây dựng một cơ sở kiến thức cá nhân bằng Markdown. Ban đầu, tôi chỉ bắt đầu với vài ghi chú đơn giản hàng ngày, và chẳng bao lâu, tôi đã có các thư mục chứa đầy những suy nghĩ được kết nối, bản nháp bài viết và tài liệu tham khảo. Obsidian nhanh chóng trở thành trung tâm cho hầu hết mọi công việc tôi thực hiện.
Nhưng sau nhiều tháng tổ chức suy nghĩ và ghi chép mọi thứ, tôi bắt đầu ước mình có thể chia sẻ một số nội dung đó – không phải tất cả, mà chỉ những phần tôi muốn người khác thấy hữu ích. Hơn nữa, tôi muốn truy cập một vài ghi chú Obsidian của mình từ mọi nơi, ngay cả khi không mở ứng dụng.
Vấn đề là, việc xuất bản các tệp Markdown thành một trang web sạch, dễ điều hướng nghe có vẻ phức tạp hơn những gì tôi mong muốn. Khi tìm kiếm một công cụ có thể giúp tôi lưu trữ Obsidian Vault của mình trên internet, tôi đã tìm thấy Quartz, và nó đã thay đổi mọi thứ.
Giao diện website Obsidian trên màn hình laptop
Quartz Là Gì? Công Cụ Miễn Phí Thay Đổi Cách Bạn Chia Sẻ Kiến Thức
Trình tạo trang tĩnh dành riêng cho Markdown và người dùng Obsidian
Quartz là một trình tạo trang tĩnh được tạo ra đặc biệt để xuất bản các tệp Markdown. Nó là mã nguồn mở, được cập nhật thường xuyên và quan trọng nhất là nó hiểu cách các công cụ Markdown như Obsidian hoạt động – bao gồm cả backlinks, thư mục, front matter và tất cả các tính năng khác.
Không giống như các giải pháp khác cố gắng điều chỉnh ghi chú của bạn vào cấu trúc riêng của chúng, Quartz chấp nhận cách bạn đã tổ chức mọi thứ. Nó không thay thế Obsidian – mà thực sự bổ sung cho nó. Bạn viết và tổ chức ghi chú của mình trong Obsidian như bình thường, sau đó sử dụng Quartz để biến chúng thành một trang web công khai trông đẹp mắt và hoạt động tốt. Không có liên kết bị hỏng, không cần chuyển đổi thủ công, không cần phải vật lộn với HTML hoặc CSS trừ khi bạn muốn.
Những Tính Năng Nổi Bật Của Quartz: Tại Sao Nó Vượt Trội?
Ngoài Quartz, có một vài trình tạo trang web khác, nhưng đây là lý do tại sao tôi gắn bó với nó:
Thiết kế riêng cho người dùng Obsidian
Quartz hiểu cách Obsidian quản lý ghi chú. Nó không yêu cầu bạn làm phẳng cấu trúc thư mục hay định dạng lại các tệp Markdown của bạn. Backlinks hoạt động, liên kết nội bộ được giải quyết, và cấu trúc trực quan vẫn đúng với vault của bạn. Ngay cả phương pháp Zettelkasten cũng được bảo toàn nếu đó là phong cách của bạn.
Dễ dàng tùy chỉnh mà không cần viết code
Bạn không cần phải chạm vào CSS hoặc 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 xử 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 một thao tác bật/tắt. Ngoài ra còn có các điều khiển dựa trên Markdown, như draft: true, giúp quản lý khả năng hiển thị mà không cần đào sâu vào các tệp.
Nhanh chóng và đảm bảo quyền riêng tư
Quartz tạo ra các tệp tĩnh, làm cho trang web cuối cùng nhanh chóng và dễ dàng để lưu trữ. Tôi sử dụng GitHub Pages, nhưng Netlify cũng hoạt động rất tốt. Vì nó không dựa vào phân tích của bên thứ ba hoặc 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 bạn chỉ muốn truy cập từ xa vào ghi chú của mình qua mạng cục bộ (LAN).
Tìm kiếm, thẻ (tags) và điều hướng tích hợp
Một trong những điều 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), backlinks và một chức năng tìm kiếm gốc không yêu cầu dịch vụ của bên thứ ba. Nó tôn trọng việc gắn thẻ theo kiểu Obsidian, vì vậy mọi thứ vẫn nhất quán với cấu trúc nội bộ của bạn.
Hướng Dẫn Chi Tiết Cài Đặt và Triển Khai Quartz
Thành thật mà nói, việc thiết lập Quartz không phải là quá đơn giản, nhưng nếu bạn cẩn thận làm theo các bước tôi đã thực hiện, bạn sẽ mất chưa đến 15 phút.
Bước 1: Kiểm tra các điều kiện tiên quyết
Kiểm tra phiên bản Node.js, npm và Git trên cửa sổ Command Prompt
Trước khi tiến hành thiết lập Quartz để biến Obsidian Vault của tôi thành một trang web, tôi đã xác minh rằng hệ thống của mình có các công cụ cần thiết sau:
- Node.js: Phiên bản 20 trở lên. 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.
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 hoạt động.
Bước 2: Clone và thiết lập Quartz
Quá trình sao chép kho lưu trữ Quartz trong Command Prompt
Tiếp theo, tôi đã clone kho lưu trữ Quartz của jackyzha0 trên GitHub. Cùng với đó, tôi cũng cài đặt các dependencies. Để làm điều đó, tôi đã khởi chạy 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
Ở đây, “Quartz” trong lệnh đầu tiên là tên thư mục trên máy tính của tôi, nơi tôi đã clone kho lưu trữ. Trong quá trình npx quartz create, tôi đã chọn các tùy chọn phù hợp dựa trên sở thích của mình. Nếu bạn không có lựa chọn cụ thể nào, hãy chọn các tùy chọn mặc định.
Bước 3: Tích hợp Obsidian Vault của tôi
Sao chép các tệp Markdown của Obsidian vào thư mục Content của Quartz
Bây giờ, thông qua File Explorer, tôi đã mở thư mục chứa Obsidian Vault mà tôi muốn lưu trữ trên internet. Tôi đã 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 tôi (trong trường hợp của tôi, nó có tên là Quartz).
Bước 4: Xem trước trang web của tôi cục bộ
Xem trước trang web Quartz cục bộ qua trình duyệt
Giờ đây, trước khi triển khai trang web, tôi đã 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 đó, tôi đã khởi chạy Command Prompt và sử dụng lệnh cd để điều hướng đến thư mục dự án của tôi (Quartz trong trường hợp của tôi). Sau đó, tôi đã 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 nào, tôi đã truy cập http://localhost:8080 trong trình duyệt của mình để xem trang web.
Bước 5: Cấu hình kho lưu trữ GitHub
Cấu hình kho lưu trữ GitHub và các lệnh Git cần thiết
Tiếp theo, tôi đã tạo và cấu hình kho lưu trữ GitHub để triển khai các tệp Markdown của Obsidian của mình. Để làm điều đó, tôi đã mở Command Prompt và điều hướng đến thư mục dự án bằng lệnh cd. Sau đó, tôi đã 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 tôi làm nguồn gốc từ xa:
git remote add origin https://github.com/MyGitUsername/my-repo-name.git - Cam kết thay đổi – Cam kết các thay đổi của bạn:
git add .git commit -m "First Commit"
Bước 6: Thiết lập GitHub Actions để triển khai
Tạo và cấu hình tệp deploy.yml để triển khai Quartz lên GitHub Pages
Tiếp theo, tôi đã khởi chạy thư mục dự án của mình thông qua File Explorer và điều hướng đến vị trí này: .github > workflows. Tại đây, tôi đã tạo một tệp văn bản mới và đặt tên là deploy.yml. Sau đó, tôi đã 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
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
- 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 khớp với phiên bản bạn đang sử dụng cục bộ.
Bước 7: Đẩy lên GitHub
Tiếp theo, tôi đã đẩy kho lưu trữ cục bộ của mình lên GitHub. Để làm điều đó, tôi đã sử dụng lệnh này: git push -u origin v4.
Ở đây, v4 là tên nhánh. Nếu tên nhánh khác trong trường hợp của bạn, ví dụ, main, hãy sử dụng nó trong lệnh. Lệnh này sẽ kích hoạt quy trình GitHub Actions và triển khai trang web của bạn.
Bước 8: Cấu hình GitHub Pages
Chọn GitHub Actions làm nguồn cho GitHub Pages để tự động triển khai website Quartz
Đây là một bước quan trọng. Tôi đã cẩn thận cấu hình cài đặt GitHub Pages để trang web được phát trực tiếp thành công.
- Điều hướng đến Cài đặt: Tôi đã mở kho lưu trữ Quartz trên GitHub và nhấp vào “Settings”.
- Cài đặt Pages: Trong thanh bên, tôi đã nhấp vào “Pages”.
- Nguồn: Dưới “Build and deployment”, tôi đã đảm bảo rằng “GitHub Actions” được chọn làm nguồn.
Bước 9: Truy cập trang web đã triển khai của tôi
Trang web được tạo từ Obsidian Vault thông qua Quartz đã được triển khai thành công trên GitHub Pages
Sau khi quy trình hoàn tất, trang web đã có sẵn tại: https://myusername.github.io/my-repo-name/.
Đối với tôi, đó là: https://pranav711.github.io/Quartz/.
Bước 10: Tùy chỉnh trang web Obsidian Vault của tôi
Tùy chỉnh trang web Obsidian bằng cách chỉnh sửa file cấu hình quartz.config.ts
Sau khi lưu trữ thành công Obsidian Vault của tôi trên internet, tôi đã tùy chỉnh thêm bằng cách chỉnh sửa tệp quartz.config.ts, mà bạn có thể tìm thấy bên trong thư mục dự án của mình trên PC (Quartz đối với tôi). Tôi cũng đã sửa đổi nội dung trang chủ của mình bằng cách chỉnh sửa tệp index.md nằm trong thư mục Content.
Hãy rất 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 (sử dụng lệnh git push) sau mỗi thay đổi để các thay đổi cục bộ được phản ánh trên trang web của bạn.
Biến Obsidian Vault thành Website mà không cần kiến thức code chuyên sâu
Từ vault riêng tư đến trang web công khai – Quartz đã làm cho nó liền mạch
Xuất bản Obsidian Vault của tôi ban đầu cảm thấy như một nhiệm vụ chậm chạp và đầy thử thách, nhưng Quartz đã làm cho nó trở nên dễ dàng một cách đáng ngạc nhiên. Nó tôn trọng cấu trúc tôi đã xây dựng trong Obsidian, không yêu cầu tôi học một ngôn ngữ hoặc chuỗi công cụ mới, và cho tôi toàn quyền kiểm soát những gì được xuất bản.
Việc có các ghi chú của tôi có thể truy cập được dưới định dạng web giúp tôi nhìn rõ hơn các ý tưởng của mình. Nó có thể tìm kiếm, liên kết và dễ duyệt. Biết rằng mọi thứ được xây dựng trên các tệp tĩnh có nghĩa là tôi không bao giờ phụ thuộc vào máy chủ hoặc dịch vụ của người khác.
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, dễ điều hướng mà không phải mất công xây dựng từ đầu. Nó nhanh chóng, 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 các nhà văn và người ghi chú suy nghĩ. Hãy thử nó – bạn có thể sẽ xuất bản nhiều hơn những gì bạn dự định.
Nếu bạn gặp bất kỳ vấn đề nào trong quá trình này, hãy chia sẻ ý kiến của bạn trong phần bình luận bên dưới, và tôi rất sẵn lòng hỗ trợ bạn bằng mọi cách có thể.