Standalone HTML

The HTML projection is the shortest path from a Markdown file to a browser document. It can be emitted to stdout, written to a new file, or composed by a Go host that wants to provide its own page shell.

Copy page

CLI

margo check proposal.md
margo html proposal.md --output proposal.html

The default output is stdout. An explicit output path creates a file, and Margo does not replace an existing file unless --force is present.

Host-owned composition

htmlResult, err := margo.RenderHTML(rendered)
if err != nil {
    return err
}

page, err := margo.RenderHTMLPage(htmlResult, margo.HTMLPageInput{
    DependencyMode: margo.HTMLDependenciesLocal,
    Head:           siteMetadata(),
    Header:         siteNavigation(),
    Footer:         siteFooter(),
})

RenderHTML exposes the semantic document fragment and its dependency requirements. RenderHTMLPage supplies a generic page shell without claiming ownership of a publication domain. That boundary is what lets a documentation site add its own navigation—or, as this showcase does, compose a Goshtoso documentation shell.

Local or inline assets

Choose local dependencies when a host will publish an asset directory:

margo.HTMLDependenciesLocal

Choose inline dependencies when the artifact should carry its runtime and styles with it:

margo.HTMLDependenciesInline

The choice changes packaging, not the Markdown content.