The Sphinx Insider’s Guide
Everything we know about Sphinx in one document: what it costs, its grades, getting a refund, getting help and what else to look at. Read it here, or keep a copy.
Sphinx
The Insider’s Guide
Documentation generator for Python projects and beyond
Every plan, grade, refund rule and rival among docs and wiki tools, read from Sphinx’s own pages.
Made by The Sphinx developers · checked Nov 12, 2026 · toolgpa.com
Contents
- 01WelcomeWhat it is, who it suits, its grades and the ten things to know first
- 02What it costsEvery plan, the free plan, ways to pay less and how prices have moved
- 03What it doesIts main features, where it runs, what it works with and who makes it
- 04Where it standsIts grades against its category, and whether to keep it or make your own
- 05The alternativesThe tools it is most often weighed against, side by side
- 06Quick answersThe questions people ask about it, each answered in a line or two
- 07About ToolGPAWho made this guide, what else is on the site, and how to cite it
ToolGPA put this guide together from Sphinx’s own pages, its app-store listings and our grades. Every fact in it is on Sphinx’s page too, where it is kept up to date. Checked Nov 12, 2026.
Part 01 · Overview
Welcome
What it is, who it suits, its grades and the ten things to know first
2.6
GPA, above 38 of the 69 other docs and wiki tools we grade
Sphinx builds documentation from reStructuredText or MyST Markdown source files. It produces HTML, LaTeX for PDF, ePub and Texinfo, with cross-references, themes and a large extension system. It is installed from a package manager and run from the command line.
To get you started, here are 8 things to know about Sphinx, taken from its own pages and our grades.
A command-line build tool with config files and its own markup, so it needs a developer.
- 1
Best for Python-style documentation built from source files
Sphinx is a free documentation generator for Python projects and others, with cross-referencing and several output formats.
- 2
It is free
Sphinx has no paid plan at all. Free: released under a BSD-2-Clause license.
- 3
It runs on 3 platforms
macOS, Windows and Linux.
- 4
reStructuredText and MyST Markdown
Source files can be written in either syntax, with tables, code blocks and mathematical notation.
- 5
Cross-referencing
Links work between sections, figures, tables, citations, glossary terms and code objects, including across projects.
- 6
Several output formats
HTML, LaTeX for PDF, ePub and Texinfo are built from the same source.
- 7
A 2.6 GPA, above 38 of 69
That is against the other docs and wiki tools we grade, on value, the free plan, features, ease of use and platforms.
- 8
Keep it
Sphinx is free, so making your own would save you nothing.
Sphinx at a glance
- Pricing
- Free
- Free plan
- Yes
- Free trial
- None stated
- Runs on
- macOS, Windows, Linux
- Made by
- The Sphinx developers
- Category
- Docs & Wikis
- Our grade
- 2.6 GPA, good
The report card
Best for Python-style documentation built from source files
Sphinx is a free documentation generator for Python projects and others, with cross-referencing and several output formats. It is a command-line build tool with no hosted editor, so non-technical writers need another workflow, and publishing the built files is left to you.
| Subject | Grade | Comment |
|---|---|---|
| Value for money | A | Free under a BSD-2-Clause license, a program anyone can download and run, installed from PyPI, Conda, an OS package manager or Docker. That is well under 60% of the category's cheapest quarter. |
| Free plan and trial | A | No plan and no caps. The only cost is wherever you publish the built docs. |
| Features | C | reStructuredText and MyST Markdown, cross-references, several output formats, API docs from code, themes and translations. It does that job fully, but it is a smaller one: no hosted editor, and publishing is left to you. |
| Ease of use | D | A command-line build tool with config files and its own markup, so it needs a developer. |
| Platforms and integrations | C | A program for Mac, Windows and Linux. Windows install is documented through Chocolatey and macOS through Homebrew or MacPorts, and no web service or apps are listed. |
An A is worth 4 points, a B 3, a C 2, a D 1 and an F nothing. The GPA is the average of the five.
Who Sphinx is for
- Fits if you document a Python project and want API docs pulled from code
- Works for teams that want PDF and web output from one source
Who it is not for
- Not for you if your writers are non-technical, as there is no hosted editor
- Skip it if you want hosting, since it builds static files and you publish them
- Watch out: reStructuredText is its own markup, with Markdown through MyST
- Too light for a team wiki, as it has no accounts, comments or page editing in a browser
Good to know
Good for
- Python projects documenting an API from docstrings
- Teams that keep docs as files in a Git repository
- Projects that need a PDF as well as a website
Worth knowing
- It is a command-line build tool with no hosted editor, so non-technical writers need another workflow.
- It builds static files; publishing them somewhere is left to the user.
- Windows installation is documented through Chocolatey, and macOS through Homebrew or MacPorts.
Part 02 · Pricing
What it costs
Every plan, the free plan, ways to pay less and how prices have moved
Free
No paid plan at all
Sphinx is free to use.
The only cost is wherever you publish the built docs.
Open source
$0
Install it yourself from PyPI, Conda, an OS package manager or Docker. Hosting the built docs is up to you.
The free plan
Free: released under a BSD-2-Clause license.
Read from github.com on Nov 12, 2026.
Part 03 · Features
What it does
Its main features, where it runs, what it works with and who makes it
3
Places it runs: macOS, Windows and Linux
Documentation generator for Python projects and beyond. Here is what it does, as its own site describes it, and what it covers: open source, Markdown, documents.
reStructuredText and MyST Markdown, cross-references, several output formats, API docs from code, themes and translations.
- reStructuredText and MyST Markdown
- Source files can be written in either syntax, with tables, code blocks and mathematical notation.
- Cross-referencing
- Links work between sections, figures, tables, citations, glossary terms and code objects, including across projects.
- Several output formats
- HTML, LaTeX for PDF, ePub and Texinfo are built from the same source.
- API docs from code
- Autodoc builds reference pages for Python, C++ and other domains from docstrings.
- Themes and extensions
- Built-in and third-party HTML themes, plus extension points for diagrams, doctests and custom builders.
- Translations
- Supports documentation in multiple languages.
Where it runs
- macOS
- Windows
- Linux
What it works with
Its own pages name no integrations.
Sphinx is made by The Sphinx developers.
Part 04 · Standing
Where it stands
Its grades against its category, and whether to keep it or make your own
38/69
Other docs and wiki tools it is graded above
Sphinx's GPA of 2.6 is higher than 38 of the 69 other docs and wiki tools we grade, and level with 10.
It stands best on free plan and trial (A, above 51 of 69) and worst on ease of use (D, above 0).
Sphinx has no paid plan.
On features, ease of use and platforms it scores 1.7 out of 4. Nothing scores higher for less, though at least one tool matches that score at a lower price.
Each grade against the category
Every bar is all 70 docs and wiki tools we grade, cut by the letter each got. Sphinx’s own letter is outlined.
- AValue for moneyAbove 50 of 69
- AFree plan and trialAbove 51 of 69
- CFeaturesAbove 2 of 69
- DEase of useAbove 0 of 69
- CPlatforms and integrationsAbove 0 of 69
Price against what you get
Each dot is one of 63 docs and wiki tools. Further left costs less; higher up scores better on features, ease of use and platforms. Sphinx is the marked dot.
What paid plans start at, a month (each step along is roughly double) →
Keep it, or make your own?
Whether this is something you could build for yourself with an AI app builder, and what you would give up.
Keep it
Sphinx is free, so making your own would save you nothing.
And it is not the kind of software a weekend replaces.
What you could make
- Documents and Markdown: an app builder makes these well.
What you could not
- Apps for macOS, Windows and Linux that stay in step with each other.
What this rests on. Sphinx’s listing: what it does, where it runs, what it plugs into and what it costs. It is a judgement about the kind of software this is. We have not built a replacement for it, and making your own means looking after it too. How we decide, and every tool’s verdict.
Part 05 · Alternatives
The alternatives
The tools it is most often weighed against, side by side
MkDocs, Docusaurus, Read the Docs, Mintlify and GitBook
The 5 tools Sphinx is most often weighed against, with where each one differs from it.
- 2.6GPA
MkDocs
Free
Static site generator for Markdown project documentation.
- Only Sphinx lists macOS, Windows and Linux apps.
- Only MkDocs lists a web app.
- 2.8GPA
Docusaurus
Free
Open-source static site generator for documentation.
- Only Sphinx lists macOS, Windows and Linux apps.
- Only Docusaurus lists a web app.
- 2.0GPA
Read the Docs
Free plan · from $50/mo
Hosts documentation built from a Git repository.
- Only Sphinx lists macOS, Windows and Linux apps.
- Only Read the Docs lists a web app.
- Sphinx is open source, according to its own site.
- 2.2GPA
Mintlify
Free plan · from $450/mo
Documentation platform with built-in AI agents.
- Only Sphinx lists macOS, Windows and Linux apps.
- Only Mintlify lists a web app.
- Sphinx is open source, according to its own site.
- 2.4GPA
GitBook
Free plan · from $65/mo
Documentation platform for product and API docs, synced with Git.
- Only Sphinx lists macOS, Windows and Linux apps.
- Only GitBook lists a web app.
- Sphinx is open source, according to its own site.
Part 06 · Questions
Quick answers
The questions people ask about it, each answered in a line or two
11
Questions, each answered in a line or two
The short version of everything above, for when you only need the answer. Each one is told in full in its part of the guide.
Is Sphinx free?
Yes. Sphinx is free to use.
How much does Sphinx cost?
Sphinx lists one plan. Open source: $0.
What platforms does Sphinx work on?
Sphinx is available on macOS, Windows and Linux.
Does Sphinx have an Android app?
No Android app was listed when its pages were read on Nov 12, 2026. Sphinx is listed for macOS, Windows and Linux.
Does Sphinx have an iPhone app?
No iPhone app was listed when its pages were read on Nov 12, 2026. Sphinx is listed for macOS, Windows and Linux.
Is Sphinx open source?
Yes. Sphinx is open source, according to its own site.
Who makes Sphinx?
Sphinx is made by The Sphinx developers.
What are the alternatives to Sphinx?
The closest alternatives to Sphinx in our directory are MkDocs, Docusaurus, Read the Docs, Mintlify and GitBook.
How does Sphinx compare with other docs and wiki tools?
Sphinx's GPA of 2.6 is higher than 38 of the 69 other docs and wiki tools we grade, and level with 10.
Is Sphinx good value for money?
ToolGPA grades Sphinx A for value for money. Sphinx has no paid plan.
Could I make my own version of Sphinx?
Sphinx is free, so making your own would save you nothing. And it is not the kind of software a weekend replaces.
Where this guide comes from
The prices, plans, platforms and features were read from Sphinx’s own pages on Nov 12, 2026, and the grades were given on Nov 12, 2026. Graded from this listing, whose facts were read from Sphinx's own pages on 12 November 2026. Not based on using the product, and shorter than our full reviews.
Every tool we list gets five grades, A to F, each with its reason, and a GPA that averages them. How each is decided is at toolgpa.com/grades. This guide is ToolGPA’s own work; it is not made, paid for or approved by The Sphinx developers. Prices change, so check sphinx-doc.org before you buy.
Part 07 · About
About ToolGPA
Who made this guide, what else is on the site, and how to cite it
5,038
Tools graded, in 95 categories
ToolGPA grades software the way a school report grades a pupil: five subjects, a letter for each with the reason written beside it, and a GPA that averages them. Prices, plans and platforms are read from each maker’s own pages and dated, so you always know how fresh a figure is.
Every grade, review and ranking on ToolGPA is our own judgement. No company can pay for a grade or change one. Every tool on the site has a guide like this one, free to download and pass on. It all lives at toolgpa.com.
5,038
tools graded
95
categories
739
price changes on record
579
apps priced in 12 countries
What else is on toolgpa.com
- Sphinx, kept up to dateEverything in this guide, with prices and grades as they are todaytoolgpa.com/tools/sphinx
- How grades are givenThe rules behind every letter and every GPAtoolgpa.com/grades
- Value chartsWhat each tool costs against what it scores, for every categorytoolgpa.com/charts
- CompareAny two tools side by side, plan by plantoolgpa.com/compare
- Price changesEvery price rise and cut on record, each with its sourcetoolgpa.com/price-changes
- Prices by countryWhat apps cost on the App Store in 12 countriestoolgpa.com/prices-by-country
- Pay lessEvery public discount: yearly billing, students, nonprofitstoolgpa.com/save
- Keep or makeWhich tools are worth paying for, and which you could build yourselftoolgpa.com/keep-or-make
Scan for the live page
Prices and grades as they are today
Quoting this guide?
Please name ToolGPA and link to the live page, so readers can check the figures for themselves:
ToolGPA, "Sphinx: The Insider's Guide", checked Nov 12, 2026. https://toolgpa.com/tools/sphinx
Know someone choosing between docs and wiki tools?
Send them this guide: toolgpa.com/tools/sphinx/guide
ToolGPA elsewhere: youtube.com/@toolgpa
See our other guides
The best-graded docs and wiki tools after Sphinx, each with an Insider's Guide of its own.
- Docs & Wikis Insider's GuideEvery one of the 70 docs and wiki tools we grade, compared
- Zoho Writer Insider's GuideFree online word processor with AI and document automation3.6 GPA
- Google Docs Insider's GuideBrowser-based word processor, free with a Google Account3.4 GPA
- ONLYOFFICE Insider's GuideOpen-source office suite for documents, sheets, slides and PDFs3.4 GPA
Choosing software? Every tool graded, every price dated.
Compare tools at toolgpa.com ›Everything in this guide is ToolGPA’s own summary of what Sphinx’s pages, its app-store listings and public reviews said on the dates shown. Grades are our judgement under the rules at toolgpa.com/grades. Every grade, review and ranking on ToolGPA is our own judgement. No company can pay for a grade or change one. Sphinx is a trademark of its owner, and this guide is not made, paid for or approved by The Sphinx developers. Prices and plans change: check sphinx-doc.org before you buy.