Skip to content

v1.1.0 — front matter, images, task lists, footnotes, watch

Choose a tag to compare

View all tags
@leonardosalasd leonardosalasd released this 28 Jul 21:40
· 49 commits to main since this release
v1.1.0
f8595e2
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Warning

This release is broken and has been yanked from PyPI. It crashes on
import for every Python version below 3.14 (TypeError: 'function' object is not subscriptable) — meaning every command, including --version,
failed immediately. If you installed this version:

pipx upgrade doc-engine-cli
# or
pip install --upgrade doc-engine-cli

See v1.1.1
for the fix and full details.

What's New in v1.1.0

Front Matter Support

Define metadata in a --- block at the top of your Markdown:

---
title: API Reference
subtitle: Integration Guide
author: Your Team
template: modern
accent: teal
---

Command-line flags override front matter, which overrides auto-detection.

Rich Markdown

  • Local images: Embed with ![alt](local.png) → rendered as real images in the PDF.
  • Task lists: - [x] and - [ ] render as actual checkboxes.
  • Footnotes: [^1] syntax is now fully supported.

Watch Mode

doc-engine build --watch

Rebuilds on every save. Fastest way to tweak templates and colors.

Custom Templates

Point --template at your own .typ file:

doc-engine build --template ./corporate.typ

Non-destructive Output

No more overwrites. Writes report (1).pdf, report (2).pdf, … unless you use --force.

New Flags

  • --subtitle: Shown under the title.
  • --date: Override the cover date.
  • --watch: Rebuild on save.
  • --force: Overwrite existing output.
  • --template ./path.typ: Use a custom Typst template.

Breaking Changes

None. Fully backward compatible.

Testing

  • 55 test cases, all passing.
  • Built with Python 3.10+.
  • No Pandoc required.
  • No LaTeX required.
Assets 2
Loading