ReviewAI
Xếp hạngDanh mụcKhám pháTạp chíSo sánhMiễn phíTừ điển
📘Hướng dẫn05/04/2026· 31 phút đọc

Giá cả và cách sử dụng Mintlify | Sự khác biệt giữa sức mạnh của gói miễn phí và gói Pro bắt đầu từ $450/tháng (phiên bản 2026)

Mintlify cho phép bạn xuất bản một trang tài liệu với gói Starter miễn phí và phiên bản Pro, bao gồm các tính năng AI, bắt đầu ở mức 450 USD mỗi tháng (thanh toán hàng năm). Chúng tôi đã sắp xếp cấu trúc hệ thống tín dụng và phí kể từ tháng 7 năm 2026, cách bắt đầu với mint CLI cũng như những điểm khác biệt với GitBook và Docusaurus dựa trên thông tin chính thức.

Các điểm chính của bài viết này Mintlify là một nền tảng cho phép bạn tạo và xuất bản các tài liệu kỹ thuật bằng cách sử dụng tích hợp GitHub và MDX. Với gói Starter miễn phí, bạn thậm chí có thể tạo một trang web công cộng với miền tùy chỉnh. Trợ lý AI và agent cập nhật tự động bắt đầu từ gói Pro ($540/tháng, tương đương $450/tháng nếu thanh toán hàng năm). Vào tháng 5 năm 2026, phí đã thay đổi đáng kể đối với hệ thống tín dụng, vì vậy hãy cẩn thận với thông tin lỗi thời.

Hộp thông tin Ban biên tập

Starter free/Pro $540/tháng (tương đương $450/tháng nếu thanh toán hàng năm)

Gói khởi đầu miễn phí cho đến khi phát hành/5.000 tín dụng AI sẽ được cấp để dùng thử

Trợ lý/agent/Tự động hóa (Pro trở lên, thanh toán tín dụng)

Nội dung có sẵn bằng tiếng Nhật. Điều hướng chuyển đổi ngôn ngữ bằng tiếng Nhật. Giao diện người dùng quản lý bằng tiếng Anh.

GitBook・Docusaurus・ReadTheDocs

Xác nhận lần cuối: Ngày 17 tháng 7 năm 2026 bởi ban biên tập

Tôi không có thời gian để viết tài liệu API. Ngay cả khi bạn viết mã, nó cũng nhanh chóng trở nên lỗi thời vì bạn không thể theo kịp những thay đổi trong mã. Bất kỳ nhóm phát triển nào cũng nên lưu ý điều này.

Mintlify là một công cụ giải quyết trực tiếp "vấn đề thối tài liệu" này. Chỉ cần truy cập GitHub và một trang web đẹp mắt sẽ được xuất bản, đồng thời AI agent sẽ phát hiện các thay đổi về mã và thậm chí đề xuất cập nhật cho tài liệu.

Tuy nhiên, vào năm 2026, cơ cấu phí đã thay đổi đáng kể. Hầu như tất cả thông tin tiếng Nhật trên internet đều đã lỗi thời. Do đó, chúng tôi đã sửa đổi tất cả các khoản phí, cách sử dụng và sự khác biệt so với các đối thủ cạnh tranh dựa trên thông tin chính thức kể từ tháng 7 năm 2026.

Mintlify là gì?——Nền tảng tài liệu kỹ thuật trong kỷ nguyên AI

Mintlify là một nền tảng tài liệu xử lý việc tạo, xuất bản và bảo trì các tài liệu kỹ thuật cùng một lúc. Chúng tôi sử dụng phương pháp ``docs-as-code'' trong đó các trang được viết bằng MDX (định dạng Markdown mở rộng), được đồng bộ hóa với kho lưu trữ GitHub và được triển khai tự động.

Hơn 20.000 công ty sử dụng nó (tính đến tháng 7 năm 2026, trang web chính thức). Trang khách hàng chính thức liệt kê những cái tên như Anthropic, Amazon, Cognition, Solana và AT&T. Nhiều thiết kế bạn từng thấy trong tài liệu của công ty AI đều do Mintlify thực hiện.

Đối với những người không quen thuộc với thuật ngữ tài liệu dưới dạng mã, đó là ý tưởng ''quản lý tài liệu ở cùng một vị trí và sử dụng các quy trình tương tự như mã nguồn chương trình.'' Lịch sử về ai đã sửa cái gì và khi nào được lưu giữ, các thay đổi có thể được xem xét và xuất bản là tự động. Vấn đề "phiên bản mới nhất" có xu hướng xảy ra với Word và Notion sẽ biến mất về mặt cấu trúc.

Mintlify vào năm 2026 tự gọi mình là “nền tảng kiến ​​thức dành cho agent”. Chúng tôi đã chuyển trọng tâm từ việc chỉ là một công cụ tạo tài liệu sang nền tảng tài liệu mà cả con người và AI đều có thể đọc được. Đây là sự khác biệt lớn nhất giữa chúng tôi và các đối thủ cạnh tranh.

Danh sách các chức năng chính

Hãy tóm tắt những gì bạn có thể làm trước tiên. Không cần phải nhớ tên chức năng chi tiết.

chức năngNội dung
Trang web tài liệu được phát hànhTriển khai tự động với tích hợp GitHub. Hỗ trợ miền tùy chỉnh
Thành phần MDX+Trang trí để dễ đọc với các phần như Tab, Step, Accordion, v.v.
Sân chơi APITự động tạo môi trường thực thi và tham chiếu API từ đặc tả OpenAPI
Trợ lýAI trả lời câu hỏi của người dùng trong tài liệu
agentTheo dõi các thay đổi mã và đề xuất PR để cập nhật tài liệu
máy chủ MCPCho phép các công cụ AI như Claude tham khảo trực tiếp tài liệu công ty của bạn

Nói cách khác, nó được thiết kế để hoàn thành bốn giai đoạn "viết, xuất bản, trả lời và tiếp tục cập nhật" trong một dịch vụ. Mục tiêu khác với các trình tạo trang tĩnh nơi bạn viết và hoàn thành.

Vì vậy, bạn có thể sử dụng cái này với giá bao nhiêu? Hãy cùng xem điều gì khiến bạn lo lắng nhất.

Mintlify là một nền tảng tài liệu gốc AI tạo và xuất bản các trang web tài liệu dành cho nhà phát triển và tài liệu tham khảo API. Tương thích với MDX và OpenAPI, chúng tôi cung cấp tài liệu kỹ thuật bao gồm hướng dẫn, sân chơi API và ví dụ về mã. Ngoài các luồng chỉnh sửa dựa trên Git, bản xem trước cục bộ và trình chỉnh sửa web, nó còn hỗ trợ tìm kiếm tài liệu và trợ lý AI tích hợp. Nó có lợi thế khi các nhóm phát triển cung cấp SaaS hoặc API muốn xây dựng tài liệu chính thức dễ đọc và dễ bảo trì trong thời gian ngắn.

Mintlify giá bao nhiêu? Bạn có thể làm gì với gói miễn phí?

Trang giá chính thức tính đến tháng 7 năm 2026 hiển thị ba gói: Starter (miễn phí), Pro và Enterprise (vui lòng hỏi).

kế hoạchphí hàng thángNội dung chính
người mới bắt đầumiễn phíTính năng đầy đủ của nền tảng・Miền tùy chỉnh・Trình chỉnh sửa web・Xác thực・Máy chủ MCP・Sân chơi API
chuyên nghiệp$540 (tương đương $450 mỗi tháng nếu thanh toán hàng năm)Tất cả các tính năng của Starter + Agent, Assistant, Automations, Preview Deployment, Management API
Doanh nghiệpYêu cầu yêu cầuTất cả các tính năng Pro + SSO/SCIM/RBAC/SLA/Hỗ trợ di chuyển/phân tích nâng cao

Nhìn vào bảng chắc hẳn bạn đã có cảm giác “Pro đắt tiền”. Cảm giác đó là đúng. Tuy nhiên, gói miễn phí có phạm vi rộng, vì vậy hãy tập trung vào đó trước.

Gói Starter miễn phí đầy đủ đến mức đáng ngạc nhiên

Gói Starter không phải là "phiên bản dùng thử". Tất cả các chức năng cần thiết để xuất bản, bao gồm tạo và xuất bản trang tài liệu, đặt miền tùy chỉnh và xác thực người dùng, đều được bao gồm trong phạm vi miễn phí.

Nếu bạn có một mã nguồn mở do một cá nhân phát triển hoặc một tài liệu API trong giai đoạn đầu của quá trình khởi nghiệp, bạn có thể sử dụng Starter để đi đến hoạt động thực tế. Không cần phải đăng ký thẻ tín dụng.

Mặt khác, các chức năng AI (Trợ lý, agent, Tự động hóa) không được đưa vào Starter. Nó được nêu rõ trong Câu hỏi thường gặp trên trang web chính thức. Nếu bạn đang tìm kiếm AI, bạn sẽ cần Pro hoặc cao hơn.

Một mô tả khác là chức năng phát triển nhóm. Triển khai bản xem trước, cung cấp môi trường xác nhận cho từng PR và API quản lý để vận hành từ các hệ thống bên ngoài cũng có sẵn ở phía Pro. Ngược lại, nếu bạn không sử dụng cả 2 thứ này và AI thì chẳng có lý do gì để chuyển lên từ Starter.

Dùng thử các tính năng AI với bản dùng thử 14 ngày

Bạn có thể dùng thử miễn phí tất cả các tính năng, bao gồm cả tính năng AI, trong 14 ngày sau khi đăng ký. Trong thời gian dùng thử, bạn sẽ nhận được 5.000 tín dụng AI, có thể sử dụng mà không cần đăng ký thẻ (kể từ tháng 7 năm 2026).

Nếu bạn đang xem xét Pro, hãy nhớ sử dụng bản dùng thử này để đo lường mức tín dụng của bạn sẽ giảm bao nhiêu dựa trên khối lượng tài liệu của bạn trước khi ký hợp đồng. Việc thanh toán tín dụng được mô tả bên dưới có thể làm tăng đáng kể chi phí hàng tháng tùy thuộc vào cách bạn sử dụng nó.

Thay đổi sang hệ thống thanh toán tín dụng từ tháng 5 năm 2026

Đây là cốt lõi của việc sửa đổi giá này. Theo Câu hỏi thường gặp chính thức, bắt đầu từ ngày 1 tháng 5 năm 2026, các tính năng AI sẽ được tính phí dựa trên tín dụng. Bạn chỉ cần nhớ 4 điểm về cách thức hoạt động của nó.

  • Gói Pro bao gồm 10.000 tín dụng mỗi tháng
  • Khoản vượt quá được tính ở mức 0,01 USD cho mỗi tín dụng và có thể mua các gói tín dụng bổ sung.
  • Phí dư thừa có thể được tắt. Nếu bạn bỏ qua và đạt đến giới hạn, chức năng AI sẽ tự động dừng cho đến chu kỳ thanh toán tiếp theo.
  • Có một thông báo qua email cho bạn biết khi nào sắp đến giới hạn và chức năng đặt giới hạn chi tiêu.

Các câu trả lời của trợ lý AI và việc thực thi agent sẽ tiêu tốn khoản tín dụng này. Nếu bạn bật tính năng thanh toán vượt mức mà không hiểu cách sử dụng, bạn sẽ không thể đọc hóa đơn của mình, vì vậy trước tiên bạn nên bắt đầu tắt tính năng thanh toán vượt mức và cài đặt thông báo trước.

Với Enterprise, bạn có thể tự tùy chỉnh số lượng tín dụng và cũng có sẵn chiết khấu theo số lượng tùy thuộc vào số lượng cam kết.

Sự khác biệt giữa thanh toán hàng năm và hàng tháng là gì?

Khoản thanh toán hàng tháng cho Pro là 540 USD và thanh toán hàng năm tương đương 450 USD mỗi tháng. Một phép tính đơn giản cho thấy mức chênh lệch hàng năm là 1.080 USD.

Khoản thanh toán hàng tháng là $540 x 12 tháng là $6,480. Khoản thanh toán hàng năm là $450 x 12 tháng với giá $5,400. Với mức chiết khấu khoảng 17%, không có lý do gì để không chuyển sang thanh toán hàng năm một khi bạn đã quyết định sử dụng dịch vụ này. Mặt khác, trong giai đoạn đầu triển khai, khi chưa xác định được mức tiêu thụ tín dụng, việc trả tiền hàng tháng và chờ xem là điều khôn ngoan.

Cảnh giác với thông tin giá cả lỗi thời

Trong bài bình luận bằng tiếng Nhật vẫn có những mô tả như "Kế hoạch tăng trưởng $150 mỗi tháng" và "Pro $250 mỗi tháng". Thông tin này là từ hệ thống cũ.

Giá của Mintlify đã được sửa đổi nhiều lần trong một hoặc hai năm qua và tính đến tháng 7 năm 2026, Pro có giá 540 USD mỗi tháng và khoản thanh toán hàng năm tương đương 450 USD mỗi tháng. Tên gói cũng đã thay đổi từ tên cũ như Sở thích và Tăng trưởng thành Starter và Pro. Khi xem xét, hãy nhớ kiểm tra giá mới nhất trên trang giá chính thức.

Mô phỏng giá—Ước tính bằng 3 mẫu

Tôi sẽ cố gắng tính xem nó thực sự có giá bao nhiêu chỉ bằng những con số chính thức.

Giả địnhCấu trúc kế hoạchPhí hàng tháng ước tính
Tài liệu phát triển cá nhân/mã nguồn mởngười mới bắt đầu$0
Startup, AI tiêu thụ dưới 10.000 tín chỉ mỗi thángThanh toán hàng năm chuyên nghiệp$450
Các nhóm có mức tiêu thụ AI đạt 15.000 tín dụng mỗi thángThanh toán chuyên nghiệp hàng năm + 5.000 tín dụng bổ sung500 đô la

Việc tính toán ở dòng thứ ba như sau. Số tiền vượt quá: 5.000 tín dụng x 0,01 USD cho 50 USD. Pro là $450 mỗi năm, cộng thêm $500 mỗi tháng. Nếu mức dư thừa là vài nghìn tín dụng mỗi tháng thì số tiền bổ sung vào số tiền hàng tháng sẽ chỉ là vài chục đô la.

Nói cách khác, điều duy nhất chúng ta thực sự nên cảnh giác là “sự dư thừa bất thường”. Nếu bao gồm cài đặt và thông báo tắt vượt mức nêu trên, bạn sẽ gần như không bao giờ phải lo lắng về việc phát sinh phí quá mức.

Bây giờ chúng ta đã có cái nhìn tổng quan về giá cả, hãy cùng xem xét các tính năng AI xác định giá trị của Pro.

Tôi cũng muốn đọc nó

TypingMind là gì? Giá và các tùy chọn lựa chọn bắt đầu từ $39 (phiên bản 2026)

TypingMind là màn hình trò chuyện một lần, nơi bạn có thể sử dụng nhiều AI bằng khóa API của riêng mình. Chúng tôi đã sắp xếp các nội dung của Tiêu chuẩn $39, Mở rộng $79 và Cao cấp $99, phiên bản Nhóm bắt đầu từ $83 mỗi tháng, nơi lưu dữ liệu và mức độ bạn có thể sử dụng miễn phí bằng cách sử dụng thông tin chính thức kể từ tháng 8 năm 2026.

Ngày 7 tháng 8 năm 2026

14 bài toán và giải pháp triển khai AI trong các công ty xây dựng và ngành xây dựng

Phải mất nửa ngày để tạo ước tính và bạn có thể thu thập 20 báo cáo hàng ngày. Chúng tôi đã sắp xếp 14 vấn đề gặp phải khi giới thiệu AI trong ngành xây dựng dưới dạng Hỏi đáp. Hầu hết các nguyên nhân không nằm ở hiệu suất của AI mà nằm ở cách nó được phân phối. Nó bao gồm bản tóm tắt chi tiết về báo cáo hàng ngày, cách bắt đầu sau một tuần, chi phí khoảng 3.000 yên Nhật mỗi tháng và những điểm cần lưu ý về trợ cấp.

Ngày 7 tháng 8 năm 2026

Bạn có thể làm gì với các chức năng AI? Nội dung Trợ lý/agent/Tự động hóa

Mintlify có ba chức năng AI chính. Mỗi vai trò được phân chia rõ ràng.

Trợ lý——tài liệu trả lời câu hỏi

Trợ lý là một cuộc trò chuyện AI được tích hợp vào các trang tài liệu đã xuất bản. Khi người dùng hỏi: "Làm cách nào để xác thực JWT?", chúng tôi sẽ tìm kiếm toàn bộ tài liệu và cung cấp câu trả lời kèm theo liên kết đến trang lý do.

Cơ chế đằng sau hậu trường cũng đã được tiết lộ. Khi có câu hỏi, chúng tôi thực hiện tìm kiếm ngữ nghĩa và tìm kiếm toàn văn trên toàn bộ tài liệu, sau đó chuyển kết quả dưới dạng ngữ cảnh cho mô hình AI để tạo câu trả lời. Các mô hình này sử dụng các nguồn bên ngoài nhưng không có mô hình nào nêu rõ rằng chúng được đào tạo về dữ liệu người dùng.

Bạn cũng có thể nhúng Trợ lý vào ứng dụng của riêng mình bằng API. Danh sách các tính năng chính thức cũng bao gồm tích hợp công cụ hỗ trợ và tùy chỉnh hành vi của Trợ lý, với giả định rằng chúng sẽ được tích hợp vào quy trình phản hồi yêu cầu.

Đây là vai trò thực tế của Trợ lý: yêu cầu tài liệu đảm nhận phản hồi hỗ trợ chính. Đây là sự chuyển đổi từ “khiến mọi người đọc tài liệu” sang “khiến họ trả lời tài liệu”.

agent—Phát hiện các thay đổi mã và sửa tài liệu

agent là câu trả lời cho "vấn đề thối tài liệu". Nó giám sát cơ sở mã của bạn và đề xuất cập nhật tài liệu dưới dạng PR (yêu cầu kéo) khi phát hiện thấy thay đổi. Nó hoạt động cùng với Slack và GitHub, vì vậy ai đó trong nhóm có thể nói chuyện với đại diện trong Slack và yêu cầu họ sửa tài liệu.

Bạn thậm chí có thể chỉnh sửa các ví dụ về mã và nhật ký thay đổi dự thảo để có thể ngăn ngừa các sự cố khi tài liệu đã lỗi thời ngay cả sau khi tài liệu được phát hành. Đối với các nhóm không có người phụ trách tài liệu chuyên dụng, đây sẽ là lý do hợp lý nhất với mức phí 540 USD mỗi tháng.

Tự động hóa—Tự động hóa các tác vụ cập nhật định kỳ

Tự động hóa là một nhóm chức năng tự động thực hiện các tác vụ quản lý tài liệu thông thường. Giống như agent và Trợ lý, nó là Pro trở lên và tiêu tốn tín dụng để hoạt động.

Cốt lõi của khả năng AI của Mintlify là cách thay đổi mã trực tiếp dẫn đến đề xuất cập nhật tài liệu.

Chức năng được AI “đọc” cũng được đưa vào như một tính năng tiêu chuẩn.

Mặc dù thường bị bỏ qua nhưng Mintlify cũng tự động thực hiện các biện pháp chống lại việc bị AI đọc.

  • Tạo tự động llms.txt: Tự động chuẩn bị chỉ mục tài liệu cho AI
  • Máy chủ MCP: Cửa sổ nơi các công cụ AI như Claude có thể tham chiếu trực tiếp tài liệu của công ty bạn (MCP là tiêu chuẩn chung để truyền dữ liệu từ phần mềm khác sang AI)
  • Phân tích dòng agent: Trực quan hóa xem con người hay AI sẽ đọc

Lý do điều này quan trọng là vì những con số. Trong một nghiên cứu về lưu lượng truy cập do Mintlify công bố vào tháng 3 năm 2026, 45,3% yêu cầu tới các trang tài liệu do Mintlify lưu trữ đến thông qua các AI agent mã hóa AI. Gần ngang bằng với 45,8% qua trình duyệt. Hơn nữa, Mã Claude và Con trỏ chiếm 95% dòng agent.

Nói cách khác, một nửa số tài liệu kỹ thuật vào năm 2026 sẽ được AI đọc. ``Tài liệu dễ đọc cho AI'' không còn chỉ là sở thích mà là chiến lược thu hút khách hàng cho các sản phẩm hướng tới các nhà phát triển. Giá tăng của Mintlify là một dấu hiệu của sự tự tin rằng nó đi trước sự thay đổi này.

Bây giờ bạn đã biết các chức năng, hãy chuyển sang các bước thực tế.

Quy trình thiết lập—tối thiểu 30 phút để xuất bản

Triển khai Mintlify bao gồm hai giai đoạn: triển khai web và chuẩn bị môi trường cục bộ. Nếu bạn làm theo thứ tự, bạn sẽ không bị lạc.

Bắt đầu từ kho lưu trữ GitHub, có một quy trình duy nhất từ ​​chỉnh sửa cục bộ đến xuất bản sản phẩm.

Bước 1: Hoàn tất việc đăng ký trên trang web chính thức

Tạo một tài khoản tại mintlify.com/start và kết nối tài khoản GitHub của bạn. Chọn kho lưu trữ tài liệu và cài đặt Ứng dụng GitHub để kích hoạt triển khai tự động.

Tại thời điểm này, trang web đã được xuất bản với URL ~.mintlify.site. Quá trình chi tiết được tóm tắt trong phần bắt đầu nhanh chính thức.

Nếu bạn chỉ có thành viên mới làm quen với Git, bạn có thể bỏ qua kết nối Git và bắt đầu chỉ với trình chỉnh sửa web. Trong trường hợp đó, Mintlify sẽ tự động tạo một kho lưu trữ và cung cấp cách di chuyển sang kho lưu trữ của riêng bạn sau này.

Trình chỉnh sửa web được thiết kế để cho phép bạn chỉnh sửa MDX trên trình duyệt của mình và xuất bản trực tiếp. Khả năng phân tách các lối vào cho từng vai trò, chẳng hạn như CLI cục bộ dành cho kỹ sư và trình chỉnh sửa web dành cho nhà tiếp thị, khá hiệu quả trong hoạt động thực tế. Mặt sau là cùng một kho Git nên dù bạn chỉnh sửa cái nào thì lịch sử cũng sẽ là một.

Bước 2: Cài đặt CLI “mint” mới

Cài đặt CLI (công cụ dòng lệnh) để viết trong khi xem trước cục bộ.

npm i -g mint
# pnpm派なら
pnpm add -g mint

Một điều cần lưu ý. Gói mintlify cũ không còn hiện hành nữa và tài liệu chính thức sẽ hướng dẫn bạn về gói mintlify (kể từ tháng 7 năm 2026). Theo bài viết cũ, nếu bạn gõ npm i -g mintlify thì CLI cũ sẽ được cài đặt. Nếu bạn đang sử dụng CLI cũ, vui lòng làm theo các bước bên dưới để thay thế nó.

npm uninstall -g mintlify
npm cache clean --force
npm i -g mint

Node.js yêu cầu v20.17.0 trở lên. Bạn chắc chắn có thể sử dụng phiên bản LTS.

Bước 3: Tạo dự án

Nếu bạn đang bắt đầu một cái mới, hãy sử dụng mint new để tạo nó từ một mẫu. Nếu bạn có một kho lưu trữ được tạo trong quá trình triển khai, chỉ cần git clone nó.

mint new my-docs
# または既存リポジトリを取得
git clone <リポジトリURL>

mint new cũng có các cờ như --theme (chỉ định chủ đề) và --template (chỉ định mẫu) và nếu bạn bỏ qua chúng, nó sẽ tương tác lắng nghe. Cấu trúc thư mục được tạo rất đơn giản, chỉ có một tệp cấu hình và một nhóm tệp MDX.

/
├── docs.json          # 設定ファイル(ナビゲーション・色・ロゴ)
├── index.mdx          # トップページ
├── quickstart.mdx     # クイックスタート
└── api-reference/
    ├── authentication.mdx
    └── endpoints.mdx

Bước 4: Kiểm tra bản xem trước cục bộ với mint dev

mint dev

Bản xem trước trông giống như phiên bản thực tế sẽ khởi chạy trên localhost:3000. Nếu bạn lưu MDX, nó sẽ được phản ánh theo thời gian thực. Nếu màn hình hiển thị khác với phiên bản thực tế, vui lòng cập nhật CLI bằng bản cập nhật mới nhất.

Bước 5: Định cấu hình trang web của bạn với docs.json

Cài đặt trên toàn trang web được tóm tắt trong docs.json. Nó từng được gọi là mint.json, nhưng tài liệu chính thức hiện tại được thống nhất là docs.json. Vui lòng không sử dụng lại ví dụ cài đặt mint.json từ bài viết cũ vì cấu hình trường khác nhau.

{
  "name": "My Product",
  "logo": {
    "light": "/logo/light.svg",
    "dark": "/logo/dark.svg"
  },
  "navigation": {
    "groups": [
      {
        "group": "Getting Started",
        "pages": ["index", "quickstart"]
      },
      {
        "group": "API Reference",
        "pages": ["api-reference/authentication", "api-reference/endpoints"]
      }
    ]
  }
}

Khả năng thiết kế điều hướng là thế mạnh tiềm ẩn của Mintlify. Các phần tử sau có thể được kết hợp để điều hướng trong docs.json:

  • nhóm/trang: cấu trúc cơ bản của thanh bên
  • tab / neo / thả xuống: Phân loại chính trong menu và điều hướng trên cùng
  • phiên bản: Xuất bản song song các tài liệu API v1 và v2 và chuyển đổi giữa chúng bằng cách sử dụng menu thả xuống. Cũng hỗ trợ chỉ định phiên bản mặc định và hiển thị huy hiệu "Mới nhất" và "Beta".
  • ngôn ngữ: Điều hướng chuyển đổi ngôn ngữ. Tiếng Nhật cũng được hỗ trợ (xem bên dưới)

Ví dụ: để chuyển đổi phiên bản, chỉ cần thêm mảng phiên bản vào điều hướng.

{
  "navigation": {
    "versions": [
      { "version": "2.0.0", "groups": [ ... ] },
      { "version": "1.0.0", "groups": [ ... ] }
    ]
  }
}

Phiên bản đầu tiên trở thành mặc định và bạn cũng có thể thay đổi bất kỳ phiên bản nào thành mặc định trong trường mặc định. Sẽ luôn có lúc bạn muốn giữ lại phiên bản cũ của tài liệu do có sự thay đổi tiêu cực đối với API, vì vậy cơ chế này có hiệu quả vì tất cả những gì bạn phải làm là thiết lập nó.

Các điều chỉnh nhỏ cũng đã được thực hiện đối với phía docs.json, chẳng hạn như chuyển đổi cách hiển thị đường dẫn và thuộc tính thư mục tự động tạo danh sách các trang ngay trong một nhóm. Điều này có nghĩa là một tệp cấu hình duy nhất có tất cả các công cụ để ngăn chặn tình trạng "không biết mọi thứ ở đâu" trong các tài liệu lớn.

Bước 6: Xuất bản bằng git push

Khi bạn đã viết nó, chỉ cần cam kết và đẩy. Ứng dụng GitHub sẽ phát hiện và triển khai nó tự động. Nếu muốn sử dụng môi trường xác nhận dựa trên PR (triển khai bản xem trước), bạn cần có gói Pro.

Bạn có thể kiểm tra trạng thái triển khai trên trang Tổng quan của bảng thông tin. Nếu bạn thiết lập một miền tùy chỉnh sau khi xuất bản, bạn sẽ sẵn sàng để sử dụng cho sản xuất.

3 điểm khiến bạn dễ vấp ngã

Chúng ta hãy xem các sự cố thực tế được báo cáo trong quá trình thiết lập và giải pháp khắc phục chúng từ tài liệu CLI chính thức.

  1. lỗi mô-đun sắc nét (xảy ra trên Apple Silicon Mac): gỡ cài đặt và cài đặt lại mint sẽ giải quyết được
  2. Bản xem trước khác với bản sản xuất: Dấu hiệu cho thấy CLI đã lỗi thời. Vui lòng cập nhật với bản cập nhật bạc hà
  3. npx mint dev kết nối với localhost thay vì sản xuất: Sự cố đã biết qua npx. Khuyến nghị chính thức là nhập lại toàn cầu bằng npm i -g mint@latest

Tất cả đều có thể được sửa trong vài phút. Nếu gặp khó khăn, hãy nhớ rằng nguyên nhân chủ yếu là do "CL cũ hoặc phiên bản cũ". Điều tương tự cũng đúng nếu phiên bản không được hiển thị với phiên bản mint và nó sẽ được giải quyết bằng cách cài đặt lại. Chỉ trong trường hợp kết nối đến máy chủ phân phối bị chặn bởi môi trường proxy nội bộ thì mới cần tham khảo hệ thống thông tin.

Đây là dòng chảy cơ bản. Tiếp theo, hãy nói về MDX và các thành phần quyết định chất lượng viết.

MDX và các thành phần—“các thiết bị giúp đọc dễ dàng hơn” được tạo thành các thành phần

Văn bản chính của Mintlify được viết bằng MDX. Vì Markdown được chấp nhận nguyên trạng nên việc viết lại là tối thiểu ngay cả khi di chuyển từ README hoặc Notion hiện có.

Trên hết, "các thiết bị giúp tài liệu có thể đọc được" dành riêng cho tài liệu đã được đưa vào dưới dạng các thành phần.

  • <Tabs>——Chuyển đổi hiển thị các ví dụ mã theo ngôn ngữ
  • <Các bước>——Sắp xếp các quy trình theo định dạng bước
  • <Accordion>——Câu hỏi thường gặp và cách gấp bổ sung
  • <CodeGroup>——Hiển thị mã từ nhiều ngôn ngữ cùng một lúc

Với Docusaurus, bạn có thể tạo các thành phần React của riêng mình, nhưng với Mintlify, bạn chỉ phải viết chúng. Nhờ thành phần hóa này, bạn có thể tạo các trang được tổ chức tốt ngay cả khi bạn không phải là kỹ sư.

Cài đặt cho mỗi trang được thực hiện bằng cách sử dụng frontmatter của MDX (thông tin meta ở đầu tệp). Nếu bạn chỉ muốn viết lại tiêu đề và mô tả, chỉ cần mở trình soạn thảo và thay đổi hai dòng.

---
title: "はじめに"
description: "プロダクトの概要とセットアップ手順"
---

Tự động tạo tham chiếu API bằng cách liên kết với OpenAPI

Khi bạn kết nối các thông số kỹ thuật của Swagger/OpenAPI (YAML/JSON), các điểm cuối, tham số và ví dụ phản hồi sẽ tự động được phân trang. Sân chơi API cho phép người đọc dùng thử API một cách nhanh chóng.

Vì về cơ bản nó có thể loại bỏ ``sự khác biệt giữa thông số kỹ thuật và cách hiển thị'' trong các tài liệu API, nên chỉ riêng điều này đã là lý do để các công ty cung cấp API áp dụng nó. Tính năng này hiệu quả hơn đối với những nhóm duy trì tài liệu tham khảo viết tay.

Di chuyển từ các tài liệu hiện có

Tôi cũng bớt lo lắng hơn về việc di cư. Các gói di chuyển tự động chính thức có sẵn từ ReadMe và Docusaurus. Nếu bạn đang di chuyển từ các công cụ khác hoặc hệ thống tự tạo, bạn có thể nhận được hỗ trợ cá nhân bằng cách liên hệ với trang web chính thức.

Nếu nội dung là công cụ dựa trên Markdown thì công việc thực tế sẽ chủ yếu liên quan đến việc sắp xếp các tệp và định cấu hình docs.json. Rất có thể bạn sẽ phải viết lại từ đầu.

Bây giờ chúng ta đã nói về môi trường viết lách, hãy nói về cách sử dụng nó vào năm 2026: kết nối nó với một công cụ mã hóa AI.

Kết nối với các công cụ mã hóa AI—skill và máy chủ MCP

Tài liệu của Mintlify được thiết kế để dành cho các công cụ mã hóa AI như Claude Code và Cursor. Thậm chí còn có hướng dẫn thiết lập cho các công cụ AI khi bắt đầu khởi động nhanh chính thức.

Có hai loại cổng kết nối có sẵn.

kỹ năng: Một bộ hướng dẫn dạy phong cách Mintlify cho công cụ mã hóa AI. Bằng cách tải cấu trúc dự án, cách sử dụng thành phần và quy tắc tài liệu vào AI, bạn có thể viết "MDX giống Mintlify" ngay từ đầu. Để cài đặt, chỉ cần thêm các kỹ năng từ tài liệu chính thức với kỹ năng npx thêm.

Máy chủ MCP: Có 2 hệ thống. Bằng cách kết nối máy chủ MCP để tìm kiếm tài liệu, các công cụ AI có thể hoạt động trong khi tham khảo các tài liệu chính thức của Mintlify. Hơn nữa, nó có thể được kết nối với bảng điều khiển thông qua mcp.mintlify.com và được thiết kế để nhận ngay cả các hoạt động quản lý nội dung từ AI.

Nếu bạn yêu cầu Claude Code ``thêm một trang tài liệu tính năng mới'' với hai thứ này đã được cài đặt, nó sẽ tạo MDX phù hợp với cấu hình hiện có và tiếp tục cập nhật điều hướng của docs.json. Giá trị của kết nối này sẽ lớn hơn đối với các nhóm muốn AI xử lý công việc viết tài liệu thực tế.

Một máy chủ MCP cũng được đưa vào làm tiêu chuẩn trên trang tài liệu do công ty xuất bản, do đó, quy trình "viết bằng AI và để AI đọc nó" nhất quán theo cả hai cách.

3 mẹo để đưa hoạt động của bạn đi đúng hướng

Chỉ thêm công cụ sẽ không làm cho tài liệu của bạn tốt hơn. Giả sử các chức năng của Mintlify, có ba điểm chính đang hoạt động.

  1. Tham chiếu API dựa trên đặc tả OpenAPI. Nếu bạn bắt đầu tạo các trang tham khảo viết tay, cuối cùng bạn sẽ có những tài liệu tham khảo tồi. Việc tạo tự động từ các thông số kỹ thuật sẽ được tự động hóa, trong đó con người tập trung vào việc giải thích và hướng dẫn khái niệm. Sự phân công lao động này là hình thức hoạt động cơ bản của Mintlify.
  1. Hãy tạo thói quen “xem xét và hợp nhất ngay” các đề xuất PR của agent. Ngay cả khi AI đưa ra đề xuất cập nhật, nếu PR không được giám sát, tài liệu sẽ vẫn lỗi thời. Chỉ bằng cách lên lịch xem xét tài liệu mỗi tuần một lần trong lịch của mình, bạn có thể giảm đáng kể chi phí duy trì tính mới mẻ.
  1. Tìm "trang bị kẹt" trong Analytics. Mintlify có tính năng phân tích duyệt web tích hợp và với Pro, bạn cũng có thể xem phân tích dòng agent. Những trang hay đọc nhưng thoát ra nhiều là dấu hiệu của việc giải thích chưa đầy đủ. Những câu hỏi bạn hỏi Trợ lý cũng là thông tin chính giúp bạn biết tài liệu nào bị thiếu.

Tất cả ba công cụ đều có sẵn. Phần còn lại là vấn đề thói quen. Với tất cả những điều này, đã đến lúc so sánh với đối thủ cạnh tranh.

Sự khác biệt giữa GitBook, Docusaurus và ReadTheDocs là gì?

Liệt kê bốn công cụ tài liệu kỹ thuật hàng đầu. Mỗi người có một triết lý khác nhau, nên đáp án đúng là lựa chọn dựa trên “phương hướng” chứ không phải dựa trên ưu thế hay tự ti.

mụcMintlifySách GitDocusaurusĐọcTheDocs
PhíMiễn phí~/Pro $540/thángMiễn phí ~ / Trả phí là $65 mỗi tháng + phí người dùng ~Hoàn toàn miễn phí (máy chủ riêng)mã nguồn mở miễn phí/Doanh nghiệp $50/tháng ~
Phương pháp chỉnh sửaMDX + Git (có trình chỉnh sửa web)Trung tâm soạn thảo trực quanMDX+GitreST/Markdown+Git
chức năng AITrợ lý・agent・Tự động hóaagent/tìm kiếm AI (gói cao hơn)Không có (tự thực hiện)không có
Tích hợp OpenAPIThế hệ tự động + sân chơithư từphần bổ trợyếu đuối
Khả năng tùy chỉnhTrung bình (trong phạm vi của các bộ phận)thấp đến trung bìnhTốt nhất (Không phản ứng)thấp
lưu trữbao gồmbao gồmTrong nhà (Vercel, v.v.)bao gồm

Nói một cách đại khái, Mintlify dành cho "bao gồm tất cả" bao gồm AI, GitBook dành cho việc chỉnh sửa dễ dàng, Docusaurus dành cho sự tự do và ReadTheDocs dành cho văn hóa mã nguồn mở. Tôi sẽ thêm từng cái một.

GitBook——Bấm vào đây để chỉnh sửa bởi những người không phải kỹ sư

Điểm đặc biệt của GitBook là nó là một trình soạn thảo trực quan tương tự như Notion. Ngay cả những thành viên không biết Git cũng có thể viết bình thường.

Kể từ năm 2026, việc định giá sẽ dựa trên cấu trúc thanh toán kép cho từng trang web và từng người dùng. Dựa trên thông tin công khai, Premium có giá 65 USD/tháng/trang web cộng với phí hàng tháng cho mỗi người dùng và chức năng AI gần giống với bản Ultimate cao cấp hơn (bắt đầu từ 249 USD/tháng/trang web). Mặc dù nó rẻ hơn nhiều so với Mintlify Pro đối với một số ít người, nhưng sự khác biệt sẽ thu hẹp khi số lượng người và trang web tăng lên.

Nếu mục đích chính là nền tảng kiến ​​thức nội bộ thì một không gian làm việc có mục đích chung như Notion AI thường phù hợp hơn một công cụ dành riêng cho tài liệu.

Docusaurus——Tất cả là của riêng bạn để đổi lấy chi phí bằng 0

Đây là một mã nguồn mở do Meta tạo ra và bản thân phần mềm này hoàn toàn miễn phí. Bạn có thể tùy chỉnh nó bao nhiêu tùy thích với React.

Thay vào đó, việc lưu trữ, tìm kiếm, chức năng AI và điều chỉnh thiết kế đều là trách nhiệm của tôi. Đây là hiệu suất chi phí tốt nhất cho một nhóm có đủ khả năng chi trả cho số giờ công của kỹ sư, nhưng nếu bạn cho rằng "giờ công là một phần của chi phí" thì điều đó không miễn phí.

ReadTheDocs——Tiêu chuẩn Python và mã nguồn mở

Đây là dịch vụ đã trở thành tiêu chuẩn trong thế giới mã nguồn mở trong nhiều năm nhờ sự hợp tác của Sphinx. Bạn vẫn có thể sử dụng nó miễn phí cho các dự án mã nguồn mở. Phiên bản thương mại của Business có ba cấp độ: Basic $50 mỗi tháng, Advanced $150 mỗi tháng và Pro $250 mỗi tháng (kể từ tháng 7 năm 2026, trang web chính thức).

Mặc dù nó không phải là một công cụ để lựa chọn dựa trên thiết kế hoặc chức năng AI, nhưng khả năng tương thích của nó với văn hóa Python và hồ sơ theo dõi là vô song.

Kết luận lựa chọn

  • Tài liệu chính thức về sản phẩm API/SaaS → Chọn Mintlify. Không có sự kết hợp nào khác giữa thế hệ tự động OpenAPI và agent
  • Kiến thức nội bộ chủ yếu được biên tập bởi những người không phải kỹ sư → Trình soạn thảo trực quan của GitBook rất thoải mái
  • Tùy chỉnh hoàn toàn với chi phí bằng 0 → Docusaurus. Tuy nhiên, các chức năng và hoạt động của AI đều là nội bộ.
  • Dự án Python mã nguồn mở → ReadTheDocs

Nếu bạn không thể quyết định giữa bốn tùy chọn, hãy quyết định xem liệu chỉ con người sẽ đọc tài liệu hay liệu tài liệu đó có bao gồm cả AI hay không. Nếu bạn muốn AI đọc nó, Mintlify là nơi bạn nên đến.

Một cách thực tế khác để quyết định là tính ngược từ giới hạn trên của chi phí. Docusaurus hoặc Starter với giá 0 USD một tháng, GitBook hoặc ReadTheDocs với giá dưới 100 USD một tháng và Mintlify Pro với giá 500 USD một tháng. Bởi vì các giai đoạn ngân sách và các lựa chọn tương ứng chặt chẽ nên thị trường Ringi rất dễ dàng vượt qua.

Bên cạnh phần so sánh, chúng ta hãy cùng điểm qua những điểm mà các đội Nhật Bản quan tâm nhất.

Bạn có thể tạo tài liệu tiếng Nhật không?

Bạn có thể làm được điều đó. Tuy nhiên, có những điều kiện. Khi được tổ chức, nó được chia thành ba lớp.

Nội dung tiếng Nhật: Không vấn đề gì. Nếu bạn viết tiếng Nhật bằng MDX thì nó sẽ hiển thị bình thường. Ngoài ra còn có rất nhiều ví dụ về các tài liệu tiếng Nhật được xuất bản.

Chuyển đổi đa ngôn ngữ: Được hỗ trợ. Bằng cách đặt ngôn ngữ thành điều hướng trong docs.json, bạn có thể thêm menu thả xuống chuyển đổi ngôn ngữ vào trang web của mình. Danh sách các ngôn ngữ được hỗ trợ trong tài liệu chính thức bao gồm tiếng Nhật (jp) (tính đến tháng 7 năm 2026). Đó là tất cả những gì cần có trong phần cài đặt.

{
  "navigation": {
    "languages": [
      { "language": "en", "groups": [ ... ] },
      { "language": "jp", "groups": [ ... ] }
    ]
  }
}

Bạn cũng có thể tạo các biểu ngữ và chân trang riêng cho từng ngôn ngữ. Điều này có nghĩa là cấu hình trong đó phiên bản tiếng Anh và tiếng Nhật được vận hành đồng thời trên một trang web được hỗ trợ chính thức.

Màn hình quản lý/chức năng dịch: Cần phải phân biệt ở đây. Trang tổng quan và tài liệu bằng tiếng Anh và không có giao diện người dùng tiếng Nhật. Ngoài ra, do không có chức năng dịch tự động nên bạn sẽ phải tự chuẩn bị nội dung bản tiếng Nhật.

Giải pháp thực sự cho dịch thuật là sự hợp tác của công cụ mã hóa AI đã nói ở trên. Đặt phiên bản tiếng Anh của MDX vào kho lưu trữ làm bản gốc và để Claude Code và Cursor tạo bản dịch sang thư mục phiên bản tiếng Nhật. Vì là tài liệu dưới dạng mã nên các bản dịch cũng có thể được xem xét dưới dạng PR và các thao tác có thể được thiết lập để chỉ theo dõi những khác biệt được cập nhật trong văn bản gốc. Tuy không thân thiện bằng công cụ quản lý dịch thuật chuyên dụng nhưng cũng đủ dùng cho một đội ngũ kỹ sư.

Tóm lại, đối với sự hỗ trợ của Nhật Bản, ``Hiển thị và chuyển đổi được hỗ trợ chính thức, nhưng việc dịch thuật và quản lý do chúng tôi thực hiện.'' Chia sẻ giả định này ngay từ đầu sẽ tránh được sự thất vọng sau khi thực hiện.

Nếu bạn không bận tâm đến màn hình quản lý tiếng Anh, nó có thể được sử dụng làm nền tảng để xuất bản các tài liệu tiếng Nhật. Mặt khác, nó không phù hợp với những đội có khả năng quản lý giỏi tiếng Nhật. Đây là vấn đề của hệ thống chứ không phải là ưu tiên, vì vậy đây là điểm mà nhóm nên xác nhận trước khi ký hợp đồng.
Tóm tắt cho đến nay: Bạn có thể sử dụng Starter miễn phí để xuất bản. Nếu bạn cần AI, Pro ($540/tháng, tương đương $450/tháng nếu thanh toán hàng năm) + thanh toán bằng thẻ tín dụng. Mặc dù đắt hơn so với các đối thủ cạnh tranh nhưng nó lại dẫn đầu về khả năng hỗ trợ AI. Từ đây trở đi, đã đến lúc quyết định xem chúng ta có nên mua nó hay không.

Mintlify phù hợp với loại đội nào?

Nếu so sánh những thông tin công khai thì khá rõ ràng ai đúng ai sai.

đội phù hợp

  • Các công ty SaaS cung cấp API bên ngoài: Với thế hệ + sân chơi tự động OpenAPI, thời gian duy trì tài liệu tham khảo gần như bị loại bỏ.
  • Một sản phẩm dành cho các nhà phát triển muốn nắm bắt dòng tiền thông qua AI: Chỉ Mintlify mới có llms.txt, máy chủ MCP và phân tích agent làm tính năng tiêu chuẩn.
  • Các nhóm không có chuyên gia tài liệu: agent phát hành PR cập nhật, do đó cơ chế ngăn chặn sự thất bại của "thao tác một tay"

Điểm chung của cả ba là tài liệu có liên quan trực tiếp đến việc bán hàng. Nếu bạn đáp ứng được những điều kiện này thì 540 USD một tháng không hề đắt. Nếu bạn coi nó như "tài liệu bán hàng" trong thời đại mà các nhà phát triển đánh giá sản phẩm dựa trên tài liệu và các AI agent đọc tài liệu và viết mã thì nó khá rẻ.

Đội không phù hợp

  • Một tổ chức mà tất cả các biên tập viên đều không phải là kỹ sư: Hoạt động chính là Git và MDX. Có các trình soạn thảo web, nhưng các thiết kế dựa trên Git sẽ không biến mất.
  • Các công ty yêu cầu SSO do yêu cầu bảo mật: SSO, SCIM và RBAC được giới hạn ở Doanh nghiệp. Chuyên nghiệp thôi là chưa đủ
  • Một nhóm có ngân sách tài liệu vài chục nghìn yên Nhật mỗi tháng: Nếu bạn muốn sử dụng các chức năng AI, khoản đầu tư khoảng 100.000 yên Nhật mỗi tháng, bao gồm cả tín dụng. Free Starter hoặc Docusaurus là đủ

Mức độ xác thực và bảo mật

Tôi sẽ bổ sung khu vực xác thực. Bạn có thể chọn từ bốn phương thức xác thực cho người đọc: bảo vệ bằng mật khẩu, JWT, OAuth và Mintlify Auth và bạn có thể đặt chúng bất kể gói của bạn là gì. Bạn có thể chuyển đổi giữa các tài liệu công khai và riêng tư trên cơ sở một trang hoặc nhóm, do đó, một trang duy nhất có thể xử lý kết hợp các tài liệu công khai và bí mật.

Kiểm soát về phía tổ chức là một lĩnh vực doanh nghiệp. Các yêu cầu như buộc đăng nhập quản trị viên bằng SSO và tự động quản lý tài khoản bằng SCIM là những điều kiện tiên quyết đối với hợp đồng Doanh nghiệp.

Về kết quả chứng nhận và kiểm tra, chúng tôi tuân thủ SOC 2 Loại 2 và GDPR, đồng thời đang trong quá trình đạt được ISO 27001 (kể từ tháng 7 năm 2026). Báo cáo chi tiết được công bố trên Trung tâm tin cậy chính thức. Nó ở mức có thể đáp ứng được yêu cầu mua sắm của doanh nghiệp.

5 điều cần kiểm tra trước khi ký hợp đồng

Nếu bạn xác nhận điều này trong thời gian dùng thử 14 ngày, bạn sẽ không phải hối hận sau khi ký hợp đồng.

  1. Đo lường mức tiêu thụ tín dụng thực tế: Hỏi Trợ lý về số lượng người dùng dự kiến ​​và ước tính xem con số đó có nằm trong khoảng 10.000 tín dụng mỗi tháng hay không.
  2. Xác minh việc di chuyển các tài liệu hiện có: Hãy thử chỉ di chuyển 10 trang chính và xem chúng bị hỏng như thế nào.
  3. Đồng ý về quy trình chỉnh sửa: ai viết trong CLI và ai viết trong trình chỉnh sửa web. Quyết định xem có nên đưa vào đánh giá PR hay không

Đây là tất cả về chức năng. Hai khía cạnh còn lại là khía cạnh tổ chức.

  1. Yêu cầu SSO: Nếu yêu cầu hệ thống thông tin của bạn bao gồm SSO, trước tiên hãy nhận báo giá Doanh nghiệp.
  2. Khả năng chấp nhận bảng điều khiển bằng tiếng Anh: Yêu cầu các thành viên sẽ thực sự vận hành màn hình quản lý để kiểm tra mức độ phản kháng của họ.

Nếu bạn lo ngại dù chỉ một trong năm mục, câu trả lời đúng là tạm dừng hợp đồng và tiếp tục sử dụng Starter. Mặt khác, nếu bạn xóa sạch mọi thứ thì sẽ không còn tài liệu nào bị thất lạc nữa.

Ban biên tập Phán quyết

Đánh giá của ban biên tập dựa trên thông tin công khai được tóm tắt một cách trung thực.

Là một tài liệu kỹ thuật SaaS, Mintlify hiện là thứ gần nhất với một sản phẩm hoàn chỉnh. Với bộ thiết kế gồm 3 phần, tích hợp OpenAPI và chức năng AI, đây là cơ sở tài liệu khổng lồ về các sản phẩm dành cho nhà phát triển. Vào năm 2026, khi một nửa số tài liệu sẽ được xử lý bởi các AI agent, các công ty khác vẫn chưa bắt kịp thực tế là chúng được thiết kế để AI đọc theo tiêu chuẩn.

Tuy nhiên, giá cả đang lạc quan. Nếu bạn đang nghĩ về chi phí hàng tháng của hệ thống cũ là từ 150 đến 300 đô la, bạn sẽ ngạc nhiên với con số ước tính là 540 đô la mỗi tháng cộng với phí thẻ tín dụng. Chi phí tăng lên khi bạn sử dụng chức năng AI, vì vậy vui lòng đo mức tiêu thụ tín dụng của bạn trong thời gian dùng thử 14 ngày trước khi đưa ra quyết định hợp đồng.

Starter miễn phí thực sự là một món hời. Miền tùy chỉnh, xác thực và máy chủ MCP đều miễn phí, khiến nó trở thành một lựa chọn hiển nhiên cho sự phát triển cá nhân hoặc mã nguồn mở quy mô nhỏ. Chúng tôi đề xuất phương pháp tiếp cận gồm hai bước: đầu tiên xuất bản trên Starter, sau đó xem xét Pro sau khi bạn cảm thấy cần AI.

Các câu hỏi thường gặp (FAQ)

H. Nó có thể được sử dụng mà không cần liên kết với GitHub không?

Bạn có thể sử dụng nó. Nếu bạn bỏ qua kết nối Git trong quá trình giới thiệu, Mintlify sẽ tự động tạo một kho lưu trữ riêng mà bạn có thể chỉnh sửa và xuất bản chỉ bằng trình chỉnh sửa web. Ngoài ra còn có một lộ trình chính thức để di chuyển sang kho lưu trữ của riêng bạn sau này.

Q. Thời gian và điều kiện dùng thử miễn phí là gì?

Bạn có thể dùng thử tất cả các tính năng trong 14 ngày sau khi đăng ký mà không cần đăng ký thẻ tín dụng. Bao gồm tới 5.000 tín dụng cho các tính năng AI (kể từ tháng 7 năm 2026). Ngay cả sau khi thời gian dùng thử kết thúc, trang web sẽ tiếp tục được xuất bản dưới dạng gói Starter, vì vậy bạn không phải lo lắng về việc ``thử rồi biến mất.''

H. Tôi có bị tính phí cao nếu sử dụng quá nhiều tín dụng AI không?

Nó có thể được ngăn chặn. Bạn có thể tắt tính năng thanh toán vượt mức trên bảng điều khiển và trong trường hợp đó, chức năng AI sẽ tự động dừng cho đến chu kỳ thanh toán tiếp theo sau khi đạt đến giới hạn. Bạn cũng có thể đặt thông báo qua email khi đạt đến giới hạn trên, để có thể bắt đầu an toàn khi tắt giới hạn trên.

Q. Các tài liệu đầu vào có được sử dụng để đào tạo AI không?

Tính năng AI sử dụng các nhà cung cấp mô hình bên ngoài, nhưng Câu hỏi thường gặp chính thức nêu rõ rằng không nhà cung cấp nào trong số này học hỏi từ dữ liệu người dùng. Khi tạo câu trả lời, kết quả tìm kiếm trong tài liệu sẽ được chuyển tới mô hình dưới dạng ngữ cảnh.

H. Tôi đang sử dụng lệnh mintlify của CLI cũ, sử dụng như vậy có được không?

Nên thay thế. Tài liệu chính thức hiện tại được hợp nhất với gói mint (npm i -g mint) và tệp cấu hình cũng đã được di chuyển từ mint.json sang docs.json. Nếu vẫn ở trong môi trường cũ, bạn sẽ không thể theo kịp các tính năng và mẫu mới.

Hỏi. Việc di chuyển từ các tài liệu hiện có khó khăn như thế nào?

Có gói di chuyển tự động chính thức từ ReadMe và Docusaurus. Nếu bạn đang di chuyển từ các định dạng khác hoặc hệ thống được xây dựng tại nhà, bạn có thể nhận được hỗ trợ cá nhân bằng cách liên hệ với trang web chính thức. Nếu nội dung dựa trên Markdown thì chi phí di chuyển sẽ nhỏ.

H. Tôi có cần thực hiện các biện pháp bổ sung cho công cụ tìm kiếm và tìm kiếm AI không?

Những điều cơ bản là không cần thiết. Tối ưu hóa SEO được tích hợp vào dịch vụ lưu trữ và đối với AI, việc tạo tự động llms.txt và máy chủ MCP được đưa vào làm tiêu chuẩn. Bạn có thể đảm bảo rằng các tài liệu được tham chiếu thông qua các tìm kiếm AI như ChatGPT mà không cần nỗ lực thêm.

Câu hỏi: Bạn có thể cung cấp hỗ trợ mã hóa ngoài việc tạo tài liệu không?

Sự bảo vệ của Mintlify là tài liệu. Bản thân việc hoàn thành và tạo mã là miền của GitHub Copilot và Cursor, vì vậy vui lòng sử dụng kết hợp chúng. Bạn có thể so sánh bức tranh tổng thể về các công cụ hỗ trợ mã hóa trong danh mục mã hóa AI.

Khi cơ sở hạ tầng tài liệu đã sẵn sàng, đã đến lúc thiết lập môi trường mã hóa AI cho những người sẽ đọc tài liệu. Trong số hai loại chiếm 95% luồng agent, việc đọc hướng dẫn sử dụng cho Mã Claude trước tiên sẽ cho bạn ý tưởng cụ thể về cảm giác viết một "tài liệu được đọc bởi AI". Bạn cũng có thể muốn đọc phần giải thích về Con trỏ và hướng dẫn GitHub Copilot. Để có cái nhìn tổng quan đầy đủ, hãy xem hướng dẫn đầy đủ của chúng tôi về các công cụ mã hóa AI.

Bài liên quan