Skip to main content
Use Apple Shortcuts to generate PDFs from markdown using refile’s API directly from your iOS or macOS device.

Demo Shortcut

Get started quickly by installing our demo shortcut: Install refile Demo Shortcut

Creating Your Own Shortcut

Follow these steps to create a custom refile shortcut:
  1. Open the Shortcuts app on your iOS or macOS device
  2. Create a new shortcut
  3. Add a “Text” action to input your markdown content
  4. Add a “Get Contents of URL” action with the following settings:
    • URL: https://www.refile.co/api/v1/pdf/markdown
    • Method: POST
    • Headers:
      • Name: Authorization
      • Value: Bearer YOUR_API_KEY (replace with your actual API key)
    • Request Body: JSON
    • JSON:
    {
    	"markdown": "[Shortcut Input]",
    	"output": "binary",
    	"theme": "modern"
    }
    
  5. (optional) Add a “Quick Look” action to preview the PDF

Customization Options

You can customize your shortcut by modifying the JSON payload:
  • theme: Choose from various themes
  • pageNumeration: Add page numbers with “center”, “left”, “right” or “none”
  • pageSize: Set page dimensions like “A4”, “Letter”, “Legal”
  • output: Use “url” to get a download link or “binary” for direct PDF data
See the API documentation for all available options.
I