Turn Markdown into a website preview
Publish Markdown as a browser-ready preview page for docs, reports, AI outputs, specs, and client review links.
Answer First
PreviewShip can publish Markdown directly. Upload a .md/.markdown file, paste Markdown in the deploy page, or deploy a Markdown file with CLI/MCP. PreviewShip packages it with a safe viewer and returns a shareable preview URL.
Deploy build artifacts, not source-code zips.
If you upload a zip, build the project first and zip the static output folder such as dist, build, out, or public with index.html and assets. Do not zip raw React/Vue/Next source folders with package.json and node_modules. Single .html files are supported directly by console upload, pasted HTML, CLI, MCP, and the VS Code/Cursor extension.
Key takeaways
Recommended workflow
Prepare a .md or .markdown file, or paste Markdown into the deploy page.
Deploy it through the browser, CLI, MCP, VS Code, or Cursor workflow.
Open the generated preview URL to verify formatting.
Share the link or claim the guest project to keep the URL.
Comparison snapshot
Best Markdown use cases
Markdown is common for AI-generated reports, implementation notes, README drafts, specs, changelogs, and lightweight documentation. A preview URL makes that content easier to review than a raw file attachment.
When to switch to HTML
Use HTML when the output needs custom styling, scripts, embeds, or interactive widgets. Use Markdown when the main value is readable structured text.
FAQ
Can I upload Markdown directly?
Yes. PreviewShip supports .md and .markdown uploads, pasted Markdown, CLI deploys, and MCP deploys.
Will the Markdown URL stay the same after redeploying?
Yes, when you deploy to the same project. The fixed project link points to the latest deployment.
Is Markdown indexed in Showcase?
Only public, approved Showcase items are indexable. Private, password-protected, expired, or removed previews are excluded.