// Use when initializing a new MarkBind site, choosing templates, installing MarkBind, serving locally, or when a user asks how to get started with MarkBind, create a new documentation site, or scaffold a project
| name | markbind-getting-started |
| description | Use when initializing a new MarkBind site, choosing templates, installing MarkBind, serving locally, or when a user asks how to get started with MarkBind, create a new documentation site, or scaffold a project |
| paths | *.md,*.html,*.json |
MarkBind is a static site generator optimized for content-heavy instructional websites (courses, tutorials, documentation). It converts Markdown-like syntax into rich, interactive HTML websites.
global, local devDependency, or npx).site.json at project root; it is required for build/serve/deploy workflows.markbind serve during authoring; use markbind build for publish output.baseUrl correctly before deployment to avoid broken deployed links.markbind serve # Live preview (port 8080)
markbind serve -p 3000 # Custom port
markbind serve -o guide/index.md # Single-page mode
markbind serve -b # Background build (beta)
markbind build # Generate to _site/
markbind build ./src ./output # Custom dirs
markbind deploy # Deploy to GitHub Pages
my-site/
├── index.md # Landing page
├── site.json # Site configuration
├── _markbind/
│ ├── layouts/
│ │ └── default.md # Page layout
│ ├── variables.md # Global variables
│ └── variables.json # Global variables (JSON)
└── contents/ # Content pages (optional)
default, minimal, project, portfolio) and how to choose a starter.init, serve, build, deploy, and shared options.--one-page, --background-build, host/port/site-config options).markbind-authoring skillmarkbind-components skillmarkbind-site-config skillmarkbind-reuse skillmarkbind-deploy skillRefer to this skill for MarkBind-specific authoring features and formatting when writing MarkBind pages.
Use when adding MarkBind components like boxes, panels, tabs, modals, tooltips, popovers, dropdowns, navbars, search bars, cards, badges, questions, quizzes, trees, thumbnails, annotations, scroll-to-top buttons, dark mode toggles, breadcrumbs, site-nav, or page-nav to MarkBind pages
Use when deploying MarkBind sites to GitHub Pages, Netlify, or CI platforms, configuring deploy settings in site.json, setting up GitHub Actions workflows, PR previews, or when users ask about publishing, hosting, or deploying their MarkBind site
Use when creating Nunjucks macros, advanced templating patterns, dynamic content generation, loops, conditionals, custom macros for repeated component patterns, or when users ask about automating content, creating reusable component templates, or advanced Nunjucks features in MarkBind
Use when reusing content across pages with includes, defining variables, creating boilerplate templates, sharing content between sites, creating content variations, or when users ask about content reuse, DRY patterns, includes, variables, or templates in MarkBind
Use when configuring site.json, setting up layouts, frontmatter, site properties, themes, dark mode, plugins, page navigation, headers, footers, custom CSS/JS, or when users ask about site structure, site-wide settings, or page configuration