> ## Documentation Index
> Fetch the complete documentation index at: https://markdown2pdf.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Convert markdown to PDF with our high-quality engine.

Here's a few examples of how to use markdown2pdf.ai in your code.

<Tabs>
  <Tab title="Python">
    ```bash theme={null}
    pip install markdown2pdf-python
    ```

    ```python theme={null}
    from markdown2pdf import MarkdownPDF

    def pay(offer):
        print("⚡ Lightning payment required")
        print(f"Amount: {offer['amount']} {offer['currency']}")
        print(f"Description: {offer['description']}")
        print(f"Invoice: {offer['payment_request']}")
        input("Press Enter once paid...")

    client = MarkdownPDF(on_payment_request=pay)
    path = client.convert(markdown="# Hello from Python", title="My document title", download_path="output.pdf")
    print("Saved PDF to:", path)
    ```
  </Tab>

  <Tab title="Typescript">
    ```bash theme={null}
    npm install @serendipityai/markdown2pdf-typescript
    ```

    ```typescript theme={null}
    import { convertMarkdownToPdf } from "@serendipityai/markdown2pdf-typescript";
    import type { OfferDetails } from "@serendipityai/markdown2pdf-typescript";

    async function pay(offer: OfferDetails) {
      console.log("⚡ Lightning payment required");
      console.log(`Amount: ${offer.amount} ${offer.currency}`);
      console.log(`Description: ${offer.description}`);
      console.log(`Invoice: ${offer.payment_request}`);
      await new Promise<void>(resolve => { process.stdin.once("data", () => { resolve(); }); });
    }

    async function main() {
      const result = await convertMarkdownToPdf("# Hello from Typescript", {
        title: "My document title",
        downloadPath: "output.pdf",
        onPaymentRequest: pay
      });
      console.log("Saved PDF to:", result);
    }

    main().catch(console.error); 
    ```
  </Tab>

  <Tab title="MCP">
    You can drop the below configuration in to your Claude MCP config to add PDF conversion to your chat workflow.

    ```bash theme={null}
    "mcpServers": {
      "markdown2pdf": {
        "command":"npx",
        "args": ["@serendipityai/markdown2pdf-mcp"],
        "cwd": "~"
      }
    }
    ```
  </Tab>

  <Tab title="X402 (Python)">
    ```bash theme={null}
    pip install "x402[httpx]" solders
    ```

    ```python theme={null}
    import os, asyncio
    from solders.keypair import Keypair
    from x402 import x402Client, prefer_network
    from x402.http.clients.httpx import x402HttpxClient
    from x402.mechanisms.svm import KeypairSigner
    from x402.mechanisms.svm.exact import ExactSvmScheme

    async def main():
        keypair = Keypair.from_base58_string(os.environ["SOLANA_SIGNER_KEY"])
        signer = KeypairSigner(keypair)
        NETWORK = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
        x402 = x402Client()
        x402.register(NETWORK, ExactSvmScheme(signer=signer))
        x402.register_policy(prefer_network(NETWORK))
        async with x402HttpxClient(x402, timeout=120.0) as client:
            resp = await client.post(
                "https://api.markdown2pdf.ai/markdown",
                json={
                    "data": {"text_body": "# Hello from X402"},
                    "options": {"document_name": "hello.pdf"},
                },
            )
            resp.raise_for_status()
            print("Paid tx proof:", resp.headers.get("payment-response"))
            print("Poll:", resp.json()["path"])

    asyncio.run(main())
    ```

    The `x402HttpxClient` handles the 402 → sign → retry loop for you. See the
    [X402 page](/x402) for details and manual-flow variants.
  </Tab>
</Tabs>

You'll see that, in general, you pass your markdown content, a title and a download path to the `convert` function and it will handle the markdown conversion for you. A mandatory function must be provided which is used to handle the payment using a mechanism of your choice — either Lightning via [L402](/l402) or USDC on Solana via [X402](/x402). This could be a manual payment (copy-and-paste the Lightning invoice into a wallet of your choice, or sign an X402 `X-PAYMENT` header with a Solana wallet), but more likely will be handled programmatically via a Lightning wallet or a Solana signer.