[Repo Assist] Add dotnet fsdocs convert command for single-file conversion

[github-actions]

🤖 This PR was created by Repo Assist, an automated AI assistant.

Closes #811

Summary

This adds a new convert verb to the fsdocs CLI tool, enabling conversion of a single .md, .fsx, or .ipynb file to HTML (or another output format) without needing to build a full documentation site.

Usage examples:

# Convert a markdown file to HTML (output: doc.html in current directory)
dotnet fsdocs convert --input doc.md

# Convert an F# script to HTML with a specific output path
dotnet fsdocs convert --input script.fsx --output script.html

# Convert a notebook to HTML using a custom template
dotnet fsdocs convert --input notebook.ipynb --template _template.html

# Convert to another format
dotnet fsdocs convert --input doc.md --outputformat latex

# Evaluate F# code while converting
dotnet fsdocs convert --input demo.fsx --eval

# Add line numbers
dotnet fsdocs convert --input script.fsx --linenumbers

# Pass extra substitution parameters
dotnet fsdocs convert --input doc.md --parameters fsdocs-title "My Doc"

Changes

• src/FSharp.Formatting.Literate/Literate.fs: Added Literate.ConvertPynbFile public API method (parallel to the existing ConvertMarkdownFile and ConvertScriptFile)
• src/fsdocs-tool/BuildCommand.fs: Added ConvertCommand class with [(Verb("convert"))]
• src/fsdocs-tool/Program.fs: Registered ConvertCommand in the entry point
• RELEASE_NOTES.md: Added changelog entry

Options

Option	Default	Description
--input	(required)	Input file (.md, .fsx, .ipynb)
--output	(basename).(ext)	Output file path
--template	(none)	Template file (raw content written if omitted)
--outputformat	html	Output format: html, ipynb, latex, fsx, markdown
--eval	false	Evaluate F# fragments
--linenumbers	false	Add line numbers
--parameters		Extra substitution key-value pairs

When no template is provided, raw HTML content is written (just the body, no surrounding page chrome) — the same behaviour as calling Literate.ConvertMarkdownFile with no template.

Root Cause

The Literate library already exposed ConvertMarkdownFile and ConvertScriptFile for programmatic use, and the DocContent class inside the build command already performs per-file conversion. This PR wires those existing capabilities up to a new CLI verb and adds the missing ConvertPynbFile method.

Test Status

• ✅ Build succeeded (0 errors, warnings only for pre-existing System.Drawing.Common vulnerability)
• ✅ All 381 tests pass (192 Markdown, 101 Literate, 68 ApiDocs, 20 CodeFormat)
• ✅ Code formatted with Fantomas

Generated by Repo Assist for issue #811

To install this workflow, run gh aw add githubnext/agentics/workflows/repo-assist.md@b87234850bf9664d198f28a02df0f937d0447295. View source at https://github.com/githubnext/agentics/tree/b87234850bf9664d198f28a02df0f937d0447295/workflows/repo-assist.md.

[nojaf]

/repo-assist it might be time to split these commands up to multiple files.

[dsyme]

Yup these "/repo-assist" in PR comments still not working

[dsyme]

Handling this in s a separate issue #1022

[dsyme]

/repo-assist Add comprehensive unit tests for all new code and integration tests for all new features

[github-actions]

Commit pushed: b5e1d1a

Generated by Repo Assist

[dsyme]

/repo-assist I tried this out and it worked OK. However note how pandoc has this:

pandoc notebook.ipynb -s -o notebook.html

where fsdocs convert has the longer

fsdocs convert --input build.fsx --output build.md --outputformat markdown

I'd like to see more like

fsdocs convert build.fsx -o build.md 

where

• input is positional
• output format is implicit from output extension if not overridden and detectable
• -o and other shorthands for arguments

Also I'd like to see the "Integration tests for ConvertCommand" moved to a set of tests for fsdocs-tool so maybe fsdocs-tool.Tests new assembly if that makes sense

[nojaf]

Hi @nhirschey, would you mind giving this a spin?