← Learning

Markdoc

A linear, one-concept-per-lesson path through Markdoc, Stripe's open-source Markdown-based authoring format, from your first parse-transform-render call to a folder-of-pages validate-and-publish pipeline. 18 lessons · 3 tiers.

Prerequisites: No hard prerequisite, can be started cold. This is the only JavaScript/Node course in the repo, run via node instead of uv run python.

No API key needed, every lesson runs locally against fixture files. Requires Node.js (v20+) and npm, scoped to this course's own package.json, separate from the repo's Python tooling. From lessons/markdoc: npm install.

Built on Markdoc, the open-source format this course teaches.

Course source

Every lesson's README and lesson.js for this course live in the ai-agent-engineering repo.

View on GitHub →
Markdoc

Beginner

The core parse -> transform -> render pipeline, plus frontmatter.

  1. 01What Is Markdoc?GitHub
  2. 02Parsing With Markdoc.parseGitHub
  3. 03Transform and the Render TreeGitHub
  4. 04Rendering to HTMLGitHub
  5. 05Frontmatter and Document MetadataGitHub
  6. 06Checkpoint: Batch-Converting a Fixtures FolderGitHub

Intermediate

Variables, functions, custom tags, validation, partials, nesting.

  1. 07VariablesGitHub
  2. 08FunctionsGitHub
  3. 09Custom Tags With the Tag SchemaGitHub
  4. 10Attributes and ValidationGitHub
  5. 11PartialsGitHub
  6. 12Nested Tags and SlotsGitHub
  7. 13Checkpoint: A Three-Page Doc SetGitHub

Advanced

Node overrides, config composition, the React renderer, and MDX compared.

  1. 14Custom Nodes and Overriding DefaultsGitHub
  2. 15Config Composition Across FilesGitHub
  3. 16Rendering to ReactGitHub
  4. 17Markdoc vs. MDXGitHub
  5. 18Capstone: A Folder-of-Pages Validate-and-Publish PipelineGitHub
Start at Lesson 1

Contact

Book a Call