markitect-quarkdown/README.md

markitect-quarkdown

markitect-quarkdown provides the concrete Quarkdown render/export adapter for Markitect. It keeps Quarkdown runtime assumptions out of markitect-tool while still satisfying the Markitect render adapter contract.

Scope

This repository owns:

• render.quarkdown adapter descriptor and entry point
• Markitect profile to Quarkdown profile mapping
• controlled Quarkdown CLI execution plans
• Quarkdown permission and runtime dependency mapping
• generated artifact validation and checksums
• open-reuse integration metadata

It does not reimplement Quarkdown, fork Quarkdown, or make core Markitect responsible for renderer behavior.

Development

Run tests from this checkout:

PYTHONPATH=src:/home/worsch/markitect-tool/src python3 -m pytest

The suite uses fake execution for adapter-boundary tests. A real Quarkdown runtime smoke check skips when quarkdown is not installed.

Entry Point

[project.entry-points."markitect_tool.render_export_adapters"]
quarkdown = "markitect_quarkdown.adapter:quarkdown_adapter_descriptor"

Docs

• docs/adapter-boundary.md
• docs/profile-matrix.md
• docs/permissions-and-runtime.md
• integration/quarkdown.integration.yaml