


Then build a docset using: await ("docfx. You can also use docfx as a NuGet library: This example uses peaceiris/actions-gh-pages to publish to the gh-pages branch: # Your GitHub workflow file under. Upload _site folder to GitHub Pages using GitHub actions.Now you can preview the website on To preview your local changes, save changes then run this command in a new terminal to rebuild the website: docfx docfx_project/docfx.jsonĭocfx produces static HTML files under the _site folder ready for publishing to any static site hosting servers. To build the docset, run: docfx docfx_project/docfx.json -serve This command creates a new docset under the docfx_project directory. To create a new docset, run: docfx init -quiet

NET SDK installed, then open a terminal and enter the following command to install the latest docfx: dotnet tool update -g docfx In this section we will build a simple documentation site on your local machine. NET assembly, XML code comment, REST API Swagger files and markdown into rendered HTML pages, JSON model or PDF files. Windows There is a package installer at pandoc’s download page. Download the latest installer for Windows (64-bit) For alternative ways to install pandoc, see below under the heading for your operating system. Build your technical documentation site with docfx. Installing pandoc The simplest way to get the latest pandoc release is to use the installer.
