> Source URL: /index.path
---
title: PathMX
theme:
  name: flexoki
  mode: dark
  player: default
  tokens:
    base:
      font:
        body: '"Geist Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace'
        heading: '"Geist Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace'
        mono: '"Geist Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace'
      prose:
        width: 88ch
---

[@styles]: ./styles.css
[@message]: ./tags/pathmx.tags.md
[@layout]: ./tags/layout.tags.md
[@map]: ./index.map.md

<h1 class="title">PathMX <sup>Paths Markdown eXtension</sup></h1>

<nav>
  
[Methodology](#pathmx-methodology)
[Development Framework](#the-pathmx-development-framework-early-beta)
[Examples and Demos](#examples-and-demos)

</nav>

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.

<!-- [button:: Getting Started](./getting-started/index.path.md) -->

---

# PathMX Methodology

There are three core principles to the PathMX methodology:

<hstack>
  <box class="md:w-64 md:shrink-0">

![Principle 1](./files/principle-1.png)

  </box>
  <vstack align="start" class="flex-1">
    ## 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.

  </vstack>
</hstack>

---

<hstack>
  <box class="md:w-64 md:shrink-0">

![Principle 2](./files/principle-2.png)

</box>
<vstack align="start" class="flex-1">
## 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.
</vstack>
</hstack>

---

<hstack>
  <box class="md:w-64 md:shrink-0">

![Principle 3](./files/principle-3.png)

</box>
<vstack align="start" class="flex-1">
## 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.
</vstack>
</hstack>

To read a more in-depth exploration of the PathMX methodology, please read the paper below:

[button:: Read the paper](./files/pathmx-paper.pdf) or [view the talk](./CCSCNE/talk.slides.md?play=1)

---

# The 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.

The primary deployment interface is the PathMX Player, this is the interface you are using right now! If you are interested in using, or contributing to the PathMX Development Framework, please contact [Mark Johnson](mailto:mark@fellowhumans.com).

---

# Examples and Demos

PathMX can be use for a variety of purposes beyond just curriculum development. Here are some examples built with PathMX arround recent events:

## Grok 26'

- [Grok 26' Event Path (external)](https://grok26.path.app)
- [Grok 26' 10/20 Talk](./grok-26/10-20.slides.md)

## CCSCNE 2026

- [Paper Session Slides](./CCSCNE/talk.slides.md)
- [Teaspoon Programming](./demos/tsp-demo/tsp.demo.md)

## Demos

- [Task lists](./demos/task-lists.demo.md)
- [Datatype Inline Charts](./demos/datatype.demo.md)
- [Math LaTeX](./demos/discrete-demo/index.demo.md)
  <!-- - [Alien Screenplay Path](./demos/alien-screenplay/index.path.md) -->
  <!-- - [Play Demo](./demos/play-demo.demo.md) -->
- [Markdown Support](./markdown.demo.md)
<!-- - [Code Sources](./code-source.view.tsx) -->

## Custom Tags Examples

PathMX allows literate style custom tags development. Here are some examples:

- [Bookshelf](demos/bookshelf.demo.md)
- [Pomodoro Timers](demos/pomodoro.tags.md)
- [Flashcards](demos/flashcards.demo.md)

<message>
This is a work in progress. Additional examples, documentation, and tutorials are coming soon!
</message>

<!--
## Examples

- [CS Course Example](./examples/course.example.md)
- [Event Site Example](./examples/event.example.md)
- [Custom Tags/Interactions Example](./examples/tags.example.md)

If you wanted to get started quickly, point your favorite agent [here](./getting-started/agent.guide.md) to get you started or if you prefer to work through it yourself (kudos), proceed below:

[Get Started](./getting-started/index.path.md)
-->


---

## Backlinks

The following sources link to this document:

- [Back to demos](/demos/task-lists.demo.llm.md)
- [links](/markdown.demo.llm.md)