PathMX Paths Markdown eXtension
PathMX is a modern markdown-first framework for building knowledge-oriented websites. It is currently under active development and requires some moderate technical ability to use.
What you can do with PathMX:
- Author rich, interactive knowledge sites entirely in markdown
- Build custom components and interactions
- Create personalized learning paths through linked content
- Ship production-ready sites that are portable, agent-friendly, and future-proof
PathMX is both a methodology and a development framework. The methodology can be used without special tooling on any operating system.
Let's start with the methodology.
PathMX Methodology
There are three core principles to the PathMX methodology:
Principle 1: Markdown-first
Markdown is the lingua franca of modern human and agent interactions. It is a well-established, stable and portable format for authoring human-and-agent readable plain text documents with hyperlink support.
Principle 2: Explicit file types
Type hints allow you to indicate the role of a file in the name of the file. This pattern allows agents and humans to quickly intuit the purpose of a file without having to read the contents. This is especially important in modern agentic harnesses since agents naturally look at file paths to search for relevant patterns and context.
Principle 3: Hyperlinked paths
Links between documents create a natural knowledge graph and allow for creating paths through it. A large knowledge graph may have many different paths depending on where the user is coming from or entering the space.
To read a more in-depth exploration of the PathMX methodology, please read the paper below:
Read the paperThe PathMX Development Framework (Early Beta)
The PathMX Development Framework is a modern markdown-first framework for building knowledge-oriented websites. It is currently under active development and requires some moderate technical ability to use.
That said, it is in active use in several real-world courses and deployed in production in other contexts as well (this site is PathMX!).
PathMX markdown can be extended with custom "tags" that are also defined in plain, literate-style markdown files.