From installation to publishing your first documentation in under 7 minutes ⚡️
Get Marco CLI installed on your system in seconds 🚀
curl -L https://cdn.marcodocs.com/install.sh | bashDownload the latest .exe from our downloads page and add it to your PATH.
marco --versionConnect to MarcoDocs and publish your first documentation ⚡️
Sign in to your MarcoDocs dashboard and generate an API token under Settings → API Tokens.
marco auth loginEnter your API token when prompted.
cd your-project
marco docs initAnswer a few questions about your project to set up the configuration.
marco docs publishYour documentation is now live on MarcoDocs! 🎉
Transform your OpenAPI specifications into beautiful, interactive documentation 📚
marco spec publish openapi.yamlMarco CLI automatically processes your OpenAPI spec and creates interactive documentation with try-it-out features.
Add metadata, tags, and links to organize and enhance your documentation 🎨
Create a marco.yaml file to customize any service with additional metadata:
service: Your Service Name
slug: your-service-slug
description: A comprehensive description of your service
tags:
- documentation
- api
- backend
links:
- title: GitHub Repository
href: https://github.com/yourusername/your-project
description: Source code repository
- title: Live Demo
href: https://demo.yourdomain.com
description: Interactive demo
- title: API Documentation
href: https://api.yourdomain.com/docs
description: Detailed API reference
config:
docsFolder: docs
readmePath: README.mdCustomization Benefits
🎉 You're all set! Your documentation workflow is ready. Here's what you can do next:
Connect with the community and discover advanced features
Connect with other developers, share tips, and get help when you need it.
Join Discord Community →Download Marco CLI and start publishing beautiful documentation today.
Download Marco CLI