ferax564/Noma artifact and proof
Validate, render, or proof a .noma file or book manifest with the Noma CLI.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jun 13, 2026
- License
- MIT
Pinned Snippet
uses: ferax564/noma@4d86aa046d58561e382034286c3c1e6da96154eb # v0.15.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| mode | Workflow mode: render or proof. | no | render |
| input | Path to a .noma source file or book manifest. | yes | — |
| output | Output file path, or directory path when rendering --to site. | no | noma-artifact.html |
| to | Render target: html, llm, json, noma, markdown, md, site, pdf, or docx. | no | html |
| cli-package | npm package spec to install. Defaults to this action checkout. | no | "" |
| cli-version | Deprecated npm version range for @ferax564/noma-cli; ignored when cli-package is set. | no | "" |
| node-version | Node.js version used to run the CLI. | no | 20 |
| check | Run noma check before rendering. | no | true |
| strict | Use strict HTML rendering; blocks escape hatches and external CDN runtimes. Defaults to true so CI-rendered artifacts are inert; set to "false" to allow ::html/::svg/::script and CDN-backed diagram runtimes. | no | true |
| theme | HTML theme name. | no | default |
| math | Optional math mode override: katex or none. | no | "" |
| stale-days | Optional stale-citation window for the validation step. | no | "" |
| profile | Optional comma- or space-separated validator profiles to apply during validation/proof. | no | "" |
| ignore-rule | Optional comma- or space-separated validator rules to ignore during validation. | no | "" |
| op | Inline patch op JSON for proof mode. | no | "" |
| ops | Path to a patch ops JSON file for proof mode. | no | "" |
| proof-output | HTML proof artifact path when mode=proof. | no | noma-proof.html |
| proof-summary-output | Markdown proof summary path when mode=proof. | no | noma-proof.md |
| comment-pr | Post the Markdown proof summary as a pull request comment when mode=proof. | no | false |
| github-token | GitHub token used for pull request proof comments. | no | "" |
| upload-artifact | Upload the rendered output as a GitHub Actions artifact. | no | true |
| artifact-name | Artifact name when upload-artifact is true. | no | noma-render |
Outputs
| name | description |
|---|---|
| output | Rendered output path. |
| proof-output | Proof HTML output path. |
| proof-summary | Proof Markdown summary path. |
| proof-exit-code | Exit code returned by the proof command. |