mdcast 0.2.0

Markdown → DOCX/ODT/PDF/PPTX/HTML-reveal with per-page layout templates, powered by pandoc and typst
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

export CARGO_BUILD_JOBS ?= 4

.DEFAULT_GOAL := help
.PHONY: help build release check check-all fmt lint test test-unit test-integration coverage verify demo clean

help: ## Show this help
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) \
	  | awk 'BEGIN{FS=":.*?## "}{printf "  \033[36m%-18s\033[0m %s\n",$$1,$$2}'

build: ## Debug build (default features = pandoc + typst)
	cargo build

release: ## Release build
	cargo build --release

check: ## Fast typecheck (default features)
	cargo check

check-all: ## Typecheck all four feature combinations (the CI contract)
	cargo check --no-default-features
	cargo check --no-default-features --features pandoc
	cargo check --no-default-features --features typst
	cargo check

fmt: ## Apply formatting
	cargo fmt

lint: ## fmt-check + clippy, warnings are errors (mirrors CI)
	cargo fmt --check
	cargo clippy --all-targets -- -D warnings

test-unit: ## Unit tests (in-module #[cfg(test)])
	cargo test --lib --bins

test-integration: ## Integration tests (tests/ — incl. engine smoke tests; pandoc-backed ones skip if pandoc is absent)
	cargo test --test '*'

test: ## All tests
	cargo test

coverage: ## Test coverage: lcov.info + terminal summary (needs cargo-llvm-cov)
	cargo llvm-cov --lcov --output-path lcov.info
	cargo llvm-cov report --summary-only

verify: lint check-all test ## Pre-"done" gate: lint + all feature combos + all tests

demo: build ## Render the golden fixture to target/demo/ (html-reveal + pdf)
	./target/debug/mdcast render tests/golden/cover-deck.md --target html-reveal --out target/demo/cover-deck.html
	./target/debug/mdcast render tests/golden/cover-deck.md --target pdf --out target/demo/cover-deck.pdf

clean: ## Remove build artifacts
	cargo clean