Split PDF using Ruby

Split PDF files into pages and save them in individual PDF. Extract pages from a PDF to create a new PDF Document.

Try for FREE

Split PDF features

Split PDF files into pages and save them in individual PDF. Extract pages from a PDF to create a new PDF Document.

ConvertAPI Ruby library install

ConvertAPI provides a Ruby Gem that allows you to perform a Split PDF conversion with just a few lines of code. First, install the ConvertAPI Ruby SDK:

Add this line to your application's Gemfile:
gem 'convert_api'

Authenticate your Ruby library

You can obtain your secret key by signing up for a free account. Once you sign up, you'll receive 250 free conversions instantly! Grab your authentication secret from the account dashboard, and authenticate the ConvertAPI Ruby library like this:

# get your secret key here: https://www.convertapi.com/a/auth
ConvertApi.configure do |config|
   config.api_secret = 'your-api-secret'
end

Split PDF using Ruby in no time!

Once you have your authentication in place, simply copy-paste this pdf to split conversion code snippet into your Ruby project:

// Code snippet is using the ConvertAPI JavaScript Client: https://github.com/ConvertAPI/convertapi-js

// Code snippet is using the ConvertAPI Node.js Client: https://github.com/ConvertAPI/convertapi-nodejs

// Code snippet is using the ConvertAPI PHP Client: https://github.com/ConvertAPI/convertapi-php

// Code snippet is using the ConvertAPI Java Client: https://github.com/ConvertAPI/convertapi-java

// Code snippet is using the ConvertAPI C# Client: https://github.com/ConvertAPI/convertapi-dotnet

# Code snippet is using the ConvertAPI Ruby Client: https://github.com/ConvertAPI/convertapi-ruby

# Code snippet is using the ConvertAPI Python Client: https://github.com/ConvertAPI/convertapi-python

// Code snippet is using the ConvertAPI Go Client: https://github.com/ConvertAPI/convertapi-go

REM Code snippet is using the command line utility program: https://github.com/ConvertAPI/convertapi-cli

<!-- For conversions with the multiple file result please refer to this example: https://repl.it/@ConvertAPI/HTML-Form-with-multiple-file-result -->

Try the conversion online - no coding required!

You can try out advanced conversion parameters and test the conversion result online using our interactive demo tool. This tool will produce the same conversion output as if you were using the library from your solution, and it will auto-generate the code snippet for you!

Try for FREE!

Conversion parameters

Password String

Sets the password to open protected documents.

SplitByPattern String

Split PDF into chunks of pages by a pattern. For example, if you set 3,2 for a ten-page PDF, it would be divided into four PDF files that contain 3,2,3,2 pages accordingly. The pattern is repeated until there are no pages left.

SplitByCustomRange String

Split PDF by a custom range. Individual page numbers separated by commas or page ranges are supported and can be combined. For example, if set 1,3,4-5,6-9 for a ten-page PDF, it would create four PDF documents - the first PDF contains only the first page, the second PDF contains the third page, the third PDF contains pages from 3 to 5, and the last PDF contains pages from 6 to 9.

ExtractPages String

Each page included in this range will be split individually (one page per document). A page range or individual page numbers separated by a comma is supported (see SplitByCustomRange description for a detailed explanation).

MergeRanges Bool

Merge all ranges in one PDF file.

CompressPDF Bool

It tries to produce smaller output files but requires Adobe Reader 6, released in 2003 or newer, to view created PDF files.

Try Split PDF for free!