メニュー
Generate PDFs from web pages or HTML using nokap. Use when writing code that produces PDF output from URLs or HTML strings, configures paper sizes, margins, or creates element-bounded PDFs sized exactly to content.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SOC 職業分類に基づく
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/posit-dev/nokap --skill nokap-pdfコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
Capture screenshots and PDFs from raw HTML strings or local HTML files using nokap. Use when rendering HTML output from packages like Great Tables, Plotly, or custom report generators to images or PDFs.
Capture screenshots from live web pages using nokap. Use when writing code that screenshots URLs, configures viewports, handles page load timing, or captures specific page elements from remote sites.
Capture screenshots and PDFs from web pages using headless Chrome via CDP. Use when writing Python code that captures, screenshots, or renders web pages, local HTML files, or raw HTML strings to images or PDFs.
| name | nokap-pdf |
| description | Generate PDFs from web pages or HTML using nokap. Use when writing code that produces PDF output from URLs or HTML strings, configures paper sizes, margins, or creates element-bounded PDFs sized exactly to content. |
| license | MIT |
| compatibility | Requires Python >=3.10 and Chrome/Chromium installed on the system. |
Generate PDFs from web pages, local HTML files, or raw HTML strings. nokap supports two modes: full-page PDFs with standard paper dimensions, and element-bounded PDFs sized exactly to a selected element.
| Mode | When to use | How to trigger |
|---|---|---|
| Full-page PDF | Reports, articles, printable pages | webshot(url, "out.pdf") |
| Element-bounded PDF | Tables, charts, widgets for embedding | webshot(url, "out.pdf", selector="table") |
The mode is automatically selected based on whether a selector (other than
"html") or cliprect is provided.
Standard paper-sized PDF, like printing from the browser:
import nokap
# Default: letter size, 0.5" margins
nokap.webshot("https://example.com", "page.pdf")
# A4 paper
nokap.webshot("https://example.com", "page.pdf", page_size="a4")
# Landscape orientation
nokap.webshot("https://example.com", "wide.pdf", landscape=True)
# Custom margins (inches): single value for all sides
nokap.webshot("https://example.com", "tight.pdf", margins=0.25)
# Asymmetric margins: (top, right, bottom, left) in inches
nokap.webshot("https://example.com", "report.pdf", margins=(1.0, 0.75, 1.0, 0.75))
# Print CSS backgrounds (colors, images)
nokap.webshot("https://example.com", "styled.pdf", print_background=True)
| Size | Dimensions (inches) |
|---|---|
"letter" | 8.5 × 11 |
"legal" | 8.5 × 14 |
"tabloid" | 11 × 17 |
"ledger" | 17 × 11 |
"a3" | 11.7 × 16.5 |
"a4" | 8.27 × 11.7 |
"a5" | 5.83 × 8.27 |
"a6" | 4.13 × 5.83 |
The PaperSize type is a Literal union of these values.
Creates a PDF sized exactly to the selected element. The text remains selectable and the output is vector (resolution-independent). Perfect for embedding tables or charts in presentations.
import nokap
# PDF sized to a table element
nokap.webshot("https://example.com", "table.pdf", selector="table")
# PDF of a chart with padding
nokap.webshot("https://example.com", "chart.pdf", selector="#chart", expand=10)
# From raw HTML (Great Tables, Plotly, etc.)
nokap.from_html(table_html, "table.pdf", selector="table")
# With CSS backgrounds (important for styled tables)
nokap.from_html(table_html, "table.pdf", selector="table", print_background=True)
import nokap
# Full-page PDF from HTML string
html = "<html><body><h1>Report</h1><p>Content here.</p></body></html>"
nokap.from_html(html, "report.pdf", page_size="letter", margins=1.0)
# Element-bounded PDF from HTML
table_html = "<table>...</table>"
nokap.from_html(table_html, "table.pdf", selector="table", expand=5)
# Great Tables to PDF
import great_tables as gt
table = gt.GT(df).tab_header(title="Q4 Results")
nokap.from_html(table.as_raw_html(), "results.pdf", selector="table")
import nokap
# Render a local HTML file to PDF
nokap.webshot("invoice.html", "invoice.pdf")
# With options
nokap.webshot("report.html", "report.pdf", page_size="a4", margins=0.75)
# Element from a local file
nokap.webshot("dashboard.html", "chart.pdf", selector="#revenue-chart")
# Full-page PDF
nokap webshot https://example.com page.pdf
# A4 paper size
nokap webshot https://example.com doc.pdf --page-size a4
# Landscape with backgrounds
nokap webshot report.html report.pdf --landscape --print-background
# Element-bounded PDF from HTML file
nokap from-html data.html table.pdf -s "table" -e 5
zoom is ignored for PDF output. PDFs are vector format and always render at full resolution regardless of zoom setting.selector="html" triggers full-page PDF mode (with paper dimensions). Any other selector triggers element-bounded mode.print_background=True by default (different from full-page PDFs which default to False).expand (for element-bounded PDFs) is in CSS pixels.print_background=True or the colors won't appear in the PDF.margins parameter only applies to full-page PDFs. For element-bounded PDFs, use expand to add spacing."letter", "a4", "legal" (not "Letter" or "A4").| Need | Code |
|---|---|
| Standard report PDF | webshot(url, "out.pdf") |
| A4 with narrow margins | webshot(url, "out.pdf", page_size="a4", margins=0.25) |
| Landscape PDF | webshot(url, "out.pdf", landscape=True) |
| Table as vector PDF | webshot(url, "out.pdf", selector="table") |
| Table PDF with styling | from_html(html, "out.pdf", selector="table", print_background=True) |
| Chart element as PDF | webshot(url, "out.pdf", selector="#chart", expand=10) |
| Printable with backgrounds | webshot(url, "out.pdf", print_background=True) |