docfx 2.78.3

Prefix Reserved
.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet tool install --global docfx --version 2.78.3
This package contains a .NET tool you can call from the shell/command line. 
dotnet new tool-manifest
                    


                            if you are setting up this repo
                        

                    

                
dotnet tool install --local docfx --version 2.78.3
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=docfx&version=2.78.3
                    


                    

                
nuke :add-package docfx --version 2.78.3

Build your docs with docfx

NuGet ci nightly Help Wanted

Build your technical documentation site with docfx, with landing pages, markdown, API reference docs for .NET, REST API and more.

As you may have heard docfx has been transitioned to be a .NET Foundation project. Microsoft Learn no longer uses docfx and do not intend to support the project since Nov 2022.

Docfx is planned to continue as a community-driven project. We hope to produce future releases with new features and enhancements to support existing and new use cases. We also would like to invite any interested parties to be involved in this project. If you'd like to contact the community team please open a discussion thread.

Getting Started

  1. Install docfx as a global tool:

    dotnet tool install -g docfx

  2. Create and start a website locally:

    docfx init -y
docfx build docfx_project\docfx.json --serve

  3. Go to https://localhost:8080 to see the sample site.

For more information, refer to Getting Started.

Docfx publishes nightly builds to GitHub Packages, this allows you to stay up-to-date with the latest developments in Docfx.

Contributing

Use Discussions for questions and general discussions. Use Issues to report bugs and proposing features.

We welcome code contributions through pull requests, issues tagged as help-wanted are good candidate to start contributing code.

Prerequisites

Build and Test

  • Build site templates in templates directory:
    • Run npm install to restore npm dependencies.
    • Run npm run build to build the templates.
  • Run dotnet build to build the project or use Visual Studio to build docfx.sln.
  • Run dotnet test to test the project or use Visual Studio test explorer.
    • Run git lfs checkout to checkout files for snapshot testing

Branch and Release

The main branch is the default branch for pull requests and most other development activities. We occasionally use feature/* branches for epic feature development.

Releases are based on a stable main branch commit using GitHub Releases. Use of Conventional Commit is encouraged.

Docfx is not released under a regular cadence, new versions arrive when maintainers see enough changes that warrant a new releases. Sometimes we use prereleases to dogfood breaking changes and get feedbacks from the community.

Roadmap

We use Milestones to communicate upcoming changes docfx:

  • Working Set are features being actively worked on. Not every features in this bucket will be committed in the next release but they reflect top of minds of maintainers in the upcoming period.

  • Backlog is a set of feature candidates for some future releases, but are not being actively worked on.

License

This project is licensed under the MIT License.

.NET Foundation

This project is supported by the .NET Foundation.

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the .NET Foundation Code of Conduct.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
2.78.3 535,244 2/20/2025
2.78.2 155,484 11/26/2024
2.78.1 20,766 11/19/2024
2.78.0 8,275 11/18/2024
2.77.0 530,341 7/1/2024
2.76.0 345,245 4/7/2024
2.75.3 288,617 2/18/2024
2.75.2 85,013 1/27/2024
2.75.1 114,171 1/13/2024
2.75.0 13,803 1/12/2024
2.74.1 176,519 11/30/2023
2.74.0 90,792 11/20/2023
2.73.2 46,308 11/13/2023
2.73.1 16,524 11/7/2023
2.73.0 12,772 11/2/2023
2.72.1 18,064 10/28/2023
2.72.0 12,028 10/24/2023
2.71.1 8,943 10/18/2023
2.71.0 44,068 9/30/2023
2.70.4 41,809 9/18/2023
2.70.3 46,600 9/5/2023
2.70.2 2,287 9/4/2023
2.70.1 18,919 8/21/2023
2.70.0 51,968 8/2/2023
2.67.5 97,581 6/21/2023
2.67.3 24,541 6/2/2023
2.67.2 7,282 5/26/2023
2.67.1 37,388 5/16/2023
2.67.0 18,172 5/6/2023
2.66.2 37,260 4/26/2023
2.66.1 2,053 4/25/2023
2.66.0 2,356 4/24/2023
2.65.3 13,490 4/14/2023
2.65.2 5,470 4/11/2023
2.65.1 4,070 4/9/2023
2.65.0 2,111 4/7/2023
2.64.0 68,286 3/30/2023
2.63.1 9,669 3/21/2023
2.63.0 1,679 3/20/2023
2.62.2 13,535 3/7/2023
2.62.1 21,897 2/15/2023
2.62.0 1,380 2/14/2023
2.61.0 77,609 1/30/2023
2.60.2 40,994 1/20/2023
2.60.1 8,524 1/18/2023
2.60.0 4,003 1/13/2023
2.60.0-preview.2 915 12/25/2022
2.60.0-preview.1 776 12/20/2022
2.59.4 8,050 9/7/2022
2.59.3 1,602 7/6/2022
2.59.2 1,758 4/11/2022
2.59.1 941 3/31/2022
2.59.0 1,526 1/19/2022
2.58.9 1,363 11/4/2021
2.58.8 709 11/1/2021
2.58.5 685 10/26/2021
2.58.4 1,775 9/14/2021
2.58.3 929 9/7/2021
2.58.2 1,296 8/24/2021
2.58.1 709 8/23/2021
2.58.0 3,658 6/9/2021
2.57.2 1,847 4/14/2021
2.57.1 778 4/13/2021
2.57.0 862 4/9/2021
2.56.7 3,473 3/2/2021
2.56.6 4,451 12/10/2020
2.56.5 1,604 11/10/2020
2.56.4 1,247 10/20/2020
2.56.3 957 10/12/2020
2.56.2 2,569 7/27/2020
2.56.1 1,433 7/6/2020
2.56.0 1,184 6/29/2020
2.55.0 1,419 6/12/2020
2.53.1 2,585 5/11/2020
2.52.0 2,013 4/13/2020
2.51.0 1,822 3/20/2020
2.50.0 1,990 3/2/2020
2.49.0 1,031 2/17/2020
2.48.1 3,138 1/13/2020
2.48.0 2,313 12/9/2019
2.47.0 2,302 10/31/2019
2.46.0 1,612 10/14/2019
2.45.1 2,231 9/15/2019
2.45.0 1,841 8/25/2019
2.44.0 1,824 8/2/2019
2.43.2 2,517 7/2/2019
2.43.1 1,670 6/14/2019
2.42.4 2,568 5/24/2019
2.42.3 13,456 5/13/2019
2.42.2 1,083 5/10/2019
2.42.0 1,380 4/22/2019
2.41.0 2,215 3/29/2019
2.40.11 2,546 2/16/2019
2.40.10 2,115 2/1/2019
2.40.9 1,172 1/31/2019
2.40.8 1,705 1/25/2019
2.40.7 2,915 1/4/2019
2.40.5 1,186 12/19/2018
2.40.4 3,032 11/26/2018
2.40.2 2,126 11/7/2018
2.40.1 1,763 10/29/2018
2.40.0 2,443 10/12/2018
2.39.2 3,578 9/9/2018
2.39.1 1,683 9/4/2018
2.39.0 1,683 9/2/2018
2.38.1 6,604 8/16/2018
2.38.0 2,222 8/13/2018
2.37.2 2,292 7/31/2018
2.37.1 1,594 7/31/2018
2.36.2 1,888 6/13/2018
2.36.1 1,932 5/25/2018
2.36.0 1,846 5/21/2018
2.36.0-alpha-0159-g25e5900b4 1,516 4/26/2018
2.35.4 2,005 5/2/2018
2.35.3 1,876 5/2/2018
2.35.0-alpha-0153-g6da267dd4 1,518 4/25/2018
2.33.2 2,018 4/3/2018
2.33.1 1,864 4/3/2018
2.33.0 2,001 3/19/2018
2.32.2 1,631 3/12/2018
2.32.0 1,944 2/28/2018
2.31.0 2,065 2/5/2018
2.30.0 2,051 1/12/2018
2.29.1 1,902 12/29/2017
2.28.3 1,704 12/14/2017
2.28.2 1,928 12/7/2017
2.28.1 1,668 12/1/2017
2.28.0 1,666 11/30/2017
2.27.0 1,664 11/21/2017
2.26.3 1,769 10/26/2017
2.26.1 1,646 10/24/2017
2.26.0 1,643 10/23/2017
2.25.1 1,668 10/9/2017
2.25.0 1,625 10/9/2017
2.24.0 1,838 9/11/2017
2.23.1 1,756 8/22/2017
2.22.3 1,647 8/17/2017
2.22.1 1,675 8/2/2017
2.22.0 1,707 8/1/2017
2.21.2 1,638 7/26/2017
2.21.1 1,765 7/17/2017
2.20.0 1,747 7/12/2017
2.19.2 1,721 6/29/2017
2.18.5 1,731 6/15/2017
2.18.4 1,689 6/9/2017
2.18.3 1,692 6/8/2017
2.18.1 1,652 5/31/2017
2.17.5 1,693 5/23/2017
2.17.3 1,679 5/11/2017
2.17.2 1,669 5/9/2017
2.16.8 1,708 5/3/2017
2.16.7 1,665 4/26/2017
2.16.5 1,641 4/25/2017
2.16.2 1,676 4/20/2017
2.16.0 1,721 4/17/2017
2.15.5 1,805 4/6/2017
2.15.2 1,705 3/29/2017
2.13.1 1,740 3/7/2017
2.13.0 1,722 3/6/2017
2.12.1 1,738 2/14/2017
2.12.0 1,689 2/13/2017
2.11.3 1,728 2/7/2017
2.11.2 1,704 1/25/2017
2.11.1 1,672 1/24/2017
2.11.0 1,661 1/23/2017
2.10.2 1,694 1/4/2017
2.10.1 1,657 1/4/2017
2.10.0 1,784 1/3/2017
2.9.3 1,688 12/15/2016
2.9.2 1,698 12/14/2016
2.9.1 1,651 12/13/2016
2.9.0 1,741 12/12/2016
2.8.2 1,710 11/28/2016
2.8.1 1,685 11/24/2016
2.8.0 1,751 11/22/2016
2.7.3 1,998 11/8/2016
2.7.2 1,940 11/3/2016
2.7.1 1,938 11/1/2016
2.7.0 1,759 10/31/2016
2.6.3 1,773 10/25/2016
2.6.1 1,701 10/11/2016
2.6.0 1,717 10/10/2016
2.5.4 2,218 9/22/2016
2.5.3 2,070 9/20/2016
2.5.2 1,845 9/19/2016
2.5.1 1,982 9/19/2016
2.5.0 1,763 9/14/2016
2.4.0 1,729 8/29/2016
2.3.1 1,654 8/22/2016
2.3.0 1,784 8/8/2016
2.2.2 1,687 7/22/2016
2.2.1 1,651 7/19/2016
2.2.0 1,670 7/18/2016
2.1.0 1,797 6/27/2016
2.0.2 1,628 6/22/2016
2.0.1 1,638 6/7/2016
2.0.0 1,770 6/6/2016
1.9.4 2,035 5/19/2016
1.9.3 1,623 5/19/2016
1.9.0 1,574 5/16/2016
1.8.4 1,622 5/10/2016
1.8.1 1,624 5/4/2016
1.8.0 1,880 4/25/2016
1.7.2 1,653 4/20/2016
1.7.1 1,645 4/7/2016
1.7.0 1,610 4/6/2016
1.6.1 1,682 3/16/2016
1.5.0 1,723 2/22/2016
1.4.2 1,702 2/3/2016
1.4.1 1,643 2/2/2016
1.4.0 1,657 2/1/2016
1.3.7 1,678 1/21/2016
1.3.5 1,660 1/13/2016
1.3.3 1,913 1/13/2016
1.3.0 1,642 1/11/2016
1.2.2 1,721 12/30/2015
1.2.1 1,637 12/15/2015
1.2.0 2,381 12/14/2015
1.1.0 1,683 12/9/2015
1.0.0 1,925 11/20/2015
0.3.11-alpha-9-gdaed198 1,388 11/16/2015
0.3.0 1,774 11/12/2015
0.0.1-alpha-1523061607 1,432 6/23/2015
0.0.1-alpha-1523061604 1,387 6/23/2015
0.0.1-alpha-1518061325 1,366 6/18/2015
0.0.1-alpha-1518061107 1,319 6/18/2015
0.0.1-alpha-1517061543 1,406 6/17/2015
0.0.1-alpha-1517061409 1,460 6/17/2015