Markdown to PDF converter

Beta

Compose, preview, and export publication-ready PDF documents from Markdown with real-time paginated sheets, custom typography themes, automatic header/footer numbering, and manual page break controls. Everything executes locally in your browser with zero server uploads.

100% Client-Side • Never sent to servers

Format:

Layout:

Margins:

Theme:

Size:

Markdown Source

Supports GFM, Tables & Page Breaks

# CloudScale Platform API Reference
**Version:** 2.4.0-stable | **Security Level:** Confidential | **Last Updated:** September 2026

The CloudScale Platform provides low-latency edge orchestration, distributed state management, and real-time event streaming for high-throughput microservices.

> [!NOTE]
> All REST and WebSocket endpoints require cryptographic authentication via Bearer JWT tokens with the `cloudscale:read` or `cloudscale:write` scope.

---

## 1. Authentication & Base Endpoints

All requests must be directed to the edge region nearest to your compute cluster:

| Environment | Base URL | Region Routing | Status |
|:------------|:---------|:---------------|:-------|
| Production  | `https://api.cloudscale.io/v2` | Global Anycast | Operational (99.99%) |
| Staging     | `https://staging-api.cloudscale.io/v2` | US-East / EU-Central | Operational |
| Sandbox     | `https://sandbox.cloudscale.io/v2` | Local Docker / Edge | Active |

### Request Headers
Each outbound request to the platform requires the following HTTP headers:
- `Authorization: Bearer <ACCESS_TOKEN>`
- `X-Client-Version: 2026.09`
- `Content-Type: application/json`

---

## 2. Client SDK Examples

### TypeScript Client Implementation

The TypeScript SDK provides end-to-end type safety, automatic exponential backoff, and transparent session renewal:

```typescript
import { CloudScaleClient, StreamEvent } from '@cloudscale/sdk';

interface ClusterMetric {
  nodeId: string;
  cpuUsagePct: number;
  memoryMb: number;
  activeSockets: number;
}

const client = new CloudScaleClient({
  apiKey: process.env.CLOUDSCALE_API_KEY!,
  region: 'eu-west-1',
  maxRetries: 3,
});

async function streamClusterTelemetry(clusterId: string): Promise<void> {
  const stream = await client.telemetry.subscribe(clusterId);
  
  for await (const event of stream) {
    const metric = event.data as ClusterMetric;
    if (metric.cpuUsagePct > 85.0) {
      console.warn(`[ALERT] High CPU on node ${metric.nodeId}: ${metric.cpuUsagePct}%`);
      await client.orchestrator.rebalanceNode(metric.nodeId);
    }
  }
}
```

### Python Async Integration

For data engineering and machine learning workflows, utilize the asynchronous Python library:

```python
import asyncio
from typing import Optional
from cloudscale import AsyncClient, ClusterConfig, ProvisioningError

async def provision_edge_worker(
    name: str, 
    memory_limit_gb: int = 16
) -> Optional[str]:
    async with AsyncClient(timeout_seconds=30) as client:
        try:
            config = ClusterConfig(
                runtime="python3.12-cuda",
                allocated_memory_gb=memory_limit_gb,
                replicas=3,
                enable_tls=True
            )
            response = await client.clusters.provision(name, config)
            print(f"Provisioned cluster {response.cluster_id} in {response.region}")
            return response.cluster_id
        except ProvisioningError as exc:
            print(f"Failed to provision node {name}: {exc.message}")
            return None

if __name__ == "__main__":
    asyncio.run(provision_edge_worker("eu-inference-node-04"))
```

---

## 3. Endpoints & Parameter Specification

### POST `/v2/orchestrator/nodes/scale`

Dynamically scale active replica pools across geographical regions:

| Parameter | Type | Required | Description |
|:----------|:-----|:--------:|:------------|
| `clusterId` | `string` | Yes | Target 64-bit cluster UUID identifier |
| `minNodes` | `integer` | Yes | Minimum standby healthy nodes (1 - 100) |
| `maxNodes` | `integer` | Yes | Maximum dynamic autoscaling limit (1 - 500) |
| `cooldownSec` | `integer` | No | Scaling cooldown window (default: `180`) |

> [!WARNING]
> Setting `minNodes` to greater than 50 may trigger temporary quota reservations in Tier 1 cloud regions. Verify billing quotas before execution.

### Error Codes & Diagnostics

| HTTP Status | Error Code | Meaning | Recommended Action |
|:------------|:-----------|:--------|:-------------------|
| `400` | `ERR_INVALID_PAYLOAD` | Schema validation error | Inspect request body against JSON schema |
| `401` | `ERR_EXPIRED_TOKEN` | JWT token expiration | Refresh token via OAuth2 flow |
| `429` | `ERR_RATE_LIMIT_EXCEEDED` | Over 10,000 req/sec | Apply exponential backoff with jitter |
| `503` | `ERR_REGION_FAILOVER` | Edge node degraded | SDK automatically fails over to secondary |

255 words•4,419 characters•124 lines

1 page break

80%

No content to preview

Start typing markdown in the editor or select a starter template from the toolbar above.

1 page

•

255 words

•

4,419 chars

•

2 min read

.pdf

100% Private & Client-Side

Your markdown notes, contracts, and documentation are never uploaded to any server. All parsing, rendering, and PDF generation happen directly inside your browser.

Smart Page Break Engine

Control exactly where pages split using . Slicing prevents orphan headings and splits large tables cleanly.

Crisp Vector & Native Print

Export true scalable vector PDFs using the native browser print engine with injected @page rules, or download directly via jsPDF.

Publication Themes

Choose from Modern Clean, Academic Serif, Technical Docs, and Minimalist themes with customized margins, line heights, font sizes, and syntax highlighting.

Markdown Cheatsheet & Formatting Guide

Page Breaks & Callout Alerts

Use standard HTML comments to force page transitions and GitHub-style blockquotes for callout alerts:

> [!NOTE]
> Important background info for your readers.

> [!WARNING]
> Critical security or architectural caution.

Tables, Code & Task Lists

Create structured data, syntax highlighted code, and interactive checklists:

| Feature | Status | Priority |
| :--- | :---: | ---: |
| Auth API | Active | P0 |

```typescript
const client = new ApiClient({ token });
```

How to convert Markdown to PDF in 3 simple steps

Write or Upload Markdown

Paste your markdown notes, drop a .md file onto the editor, or choose one of our four production starter templates.

Configure Layout & Theme

Select paper format (A4, Letter, Legal, A3, A5), orientation, margin presets, typography themes, and configure running headers, page numbers, and dates.

Export Vector or Download

Click "Print / Vector PDF" for crystal-clear vector text and browser PDF export, or click "Download PDF" for instant client-side download.

Frequently asked questions

Are my documents uploaded or stored on any server?

No. Toolou operates 100% inside your web browser using HTML5 Canvas, modern DOM APIs, and jsPDF. Your documents, notes, internal specs, and confidential information are never sent across the network.

How do I force a page break between sections?

Simply insert  anywhere in your Markdown. You can also click the Scissors icon in the toolbar or press the shortcut button to insert it automatically.

What is the difference between "Print / Vector PDF" and "Download PDF"?

Print / Vector PDF harnesses your browser's native print rendering engine, providing true infinite-resolution vector typography and hyperlinks. Download PDF creates a standalone PDF file directly inside JavaScript using jsPDF with 300 DPI Retina image capture and vector text headers/footers.

Can I suppress headers and footers on the cover page?

Yes. Click the "Header & Footer" button on the toolbar and toggle "Suppress on First Page". This ensures your title/cover page remains clean while running headers and numbering appear starting on page 2.