Page File Types

internalpage stores the uploaded source and shows a rendered viewer by default. There is no online editor.

Run npx @internalpage/cli auth login once before publishing. The examples below use the saved token.

HTML

Upload a self-contained HTML file when the output is already browser-ready.

npx @internalpage/cli pages create ./report.html --slug q2-report

Supported extensions:

• .html
• .htm

Markdown

Upload Markdown when you want a private document URL for notes, RFCs, runbooks, release notes, or generated text reports.

npx @internalpage/cli pages create ./runbook.md --slug incident-runbook

Supported extensions:

• .md
• .markdown

Markdown pages are rendered with a GitHub-like document style. Raw HTML in the Markdown source is sanitized before the viewer page is served.

OpenAPI

Upload an OpenAPI spec when you want a private, read-only API reference.

npx @internalpage/cli pages create ./openapi.yaml --slug billing-api

Supported extensions:

• .yaml
• .yml
• .json

The file must be an OpenAPI 3.x or Swagger 2.0 document and include info.title. internalpage renders it with a Redoc-based read-only viewer.

Not included:

• try it out
• API token input
• mock server
• SDK generation

Update Behavior

Updates always target the page ID:

npx @internalpage/cli pages update pg_xxx ./openapi.yaml

The page ID and viewer URL stay stable. The latest version controls which viewer is shown.