[chaliy]

Requested by Михайло · project thread

What changed

extract_document and parse_document now accept Jupyter notebooks (.ipynb, application/x-ipynb+json, nbformat 4). This applies to the CLI, Python, Node and WASM alike. It is the third "cheap formats" PR, after #21 and #44.

• Always on, with no new dependencies (uses serde_json). Notebooks are never sniffed from bytes.
• Markdown cells go through the Markdown parser, so raw HTML is never copied. Without the markdown feature they become plain-text paragraphs.
• Code cells become fenced blocks tagged with the kernel language (sanitized). Raw cells become untagged blocks.
• Outputs:
  • stream and text/plain become ```text blocks.
  • text/markdown goes through the Markdown path.
  • Errors render as ename: evalue plus the traceback, with ANSI escapes stripped.
  • Images, HTML and widget outputs are skipped.
• Title: metadata.title, otherwise the first # heading.
• Limits: each cell checks the call's timeout and counts against max_nodes. Markdown cells share the same budget.
• New API: Format::Notebook (serialized as "ipynb", the same as as_str()), Error::NotebookExtract, stats.cells.

Also fixes a limits bug from #44

Reported by the IR thread. With no format feature enabled (--no-default-features), extract_document rendered without bounds. Always-on text, CSV and notebook input therefore ignored max_output_size and the final deadline check, and csv_integration::security_timeout_applies failed.

The fix:

• Bounded rendering is now unconditional.
• Decoding is followed by a deadline check.
• CI now runs cargo test -p markkit --no-default-features.

Why

This is the roadmap initiative "cheap formats". Notebooks are a common input for agents, and their outputs often hold the result a reader needs.

Before / After

Before:

$ markkit extract --file analysis.ipynb
Error: Unsupported format
$ cargo test -p markkit --no-default-features --test csv_integration
test security_timeout_applies ... FAILED

After:

$ markkit extract --file analysis.ipynb
# Analysis

```python
print(1 + 1)
```

```text
2
```
$ cargo test -p markkit --no-default-features
(all pass)

Tests:

• tests/notebook_integration.rs has 11 tests: mapping, ANSI stripping, metadata, detection, and security cases.
• The security cases cover malformed or 1000-deep JSON, wrong value types, raw HTML, control characters, and the timeout and max_nodes limits.
• There are unit tests and a WASM node test.
• Clippy and markkit tests pass in each of these feature sets: --no-default-features, markdown, docx,spreadsheet,markdown, default, and all features.
• check-okf is clean.

Risk

• Low. The notebook support only adds behavior, and rich outputs are dropped by design.
• The limits fix only affects builds without any format feature, which previously ignored those limits.

Checklist

• Tests added or updated
• Backward compatibility considered (CHANGELOG Added entry, knowledge T7/S18 extended, log entry for the limits fix)

---

🤖 Generated with Claude Code