pi-mdxml-context

Convert Markdown context to XML-like structure at model send time while keeping the original Markdown in session history.

What this is

pi-mdxml-context is a Pi extension for agent workflows where Markdown is convenient for humans, but explicit XML-like boundaries can make complex context easier for models to parse.

It converts loaded Markdown context files and recent Markdown tool results before each model request. Saved session history stays in Markdown; conversion happens only in the provider-bound context.

Features

• Converts Markdown context files before model requests.
• Converts Markdown tool results without mutating saved session history.
• Preserves source metadata on the generated XML root element.
• Supports frontmatter, GFM, code blocks, tables, wikilinks, and Obsidian-style callouts.
• Provides preview and on/off toggle commands.
• Skips conversion when XML output grows too large.

Install

Install the published npm package with Pi:

pi install npm:pi-mdxml-context

Pin a specific version when you want reproducible installs:

pi install npm:[email protected]

Install into the current project instead of your user Pi settings:

pi install npm:pi-mdxml-context -l

Or install from GitHub:

pi install git:github.com/eiei114/pi-mdxml-context

Try it without permanently installing:

pi -e npm:pi-mdxml-context

Quick start

After install, reload Pi if needed:

/reload

Check that conversion is active:

/mdxml:status

Preview XML-like output for a Markdown file:

/mdxml:preview path/to/file.md

For commands, output shape, runtime hooks, and safety behavior, see docs/usage.md.

Usage summary

| Command | Description | | --- | --- | | /mdxml:on | Enable send-time conversion. | | /mdxml:off | Disable send-time conversion. | | /mdxml:status | Show conversion state and recent stats. | | /mdxml:preview <path> | Preview XML-like output for a Markdown file. | | /mdxml:preview recent:N | Preview XML-like output for a recent Markdown tool result. |

Conversion is enabled by default after the extension loads. Use /mdxml:off to disable it immediately.

Package contents

| Path | Purpose | | --- | --- | | index.ts | Pi TypeScript extension entrypoint | | tests/ | Converter, runtime hook, and preview tests | | docs/ | Usage and release docs (usage.md, release.md) | | README.md | Public entrypoint (this file) | | CHANGELOG.md | Version history | | CODE_OF_CONDUCT.md | Contributor Covenant code of conduct | | CONTRIBUTING.md | Contribution guidelines | | SECURITY.md | Vulnerability reporting | | LICENSE | MIT license |

Development

npm install
npm run check
npm test

Before opening a PR with publishable changes, bump package.json and update CHANGELOG.md in the same PR. CI runs npm run version:check on pull requests.

Release

This package uses npm Trusted Publishing with GitHub Actions OIDC — no NPM_TOKEN is required.

On main, a version bump in package.json triggers Auto Release, which creates the semver tag and GitHub Release, then dispatches Publish to npm (publish.yml).

See docs/release.md for setup details and tag-to-npm verification steps. See CHANGELOG.md for semver history.

Security

Pi packages run with your local permissions. Review extensions before installing third-party packages.

For vulnerability reporting, see SECURITY.md.

Links

• npm: https://www.npmjs.com/package/pi-mdxml-context
• GitHub: https://github.com/eiei114/pi-mdxml-context
• Issues: https://github.com/eiei114/pi-mdxml-context/issues
• Roadmap: ROADMAP.md

License

MIT