Tcl Requires Chilkat v11.7.0+

PDF to Markdown Options: Page Breaks, Images, Tables, Emphasis, Heading Levels

See more PDF Text Extraction Examples

Demonstrates the options of the "markdown" operation: pageBreaks (comment, rule or none), images (placeholder or none), tables (ruled or none), emphasis, and maxHeadingLevel. Tcl

load ./chilkat.dll

set success 0

#  This example requires the Chilkat API to have been previously unlocked.
#  See Global Unlock Sample for sample code.

#  The two-page PDF used in this example is available at markdown_options.pdf

set pdf [new_CkPdf]

set success [CkPdf_LoadFile $pdf "qa_data/pdf/markdown_options.pdf"]
if {$success == 0} then {
    puts [CkPdf_lastErrorText $pdf]
    delete_CkPdf $pdf
    exit
}

set json [new_CkJsonObject]

set sbMarkdown [new_CkStringBuilder]

set jsonOut [new_CkJsonObject]

#  First with the default options.
set success [CkPdf_ExtractTextSb $pdf "markdown" $json $sbMarkdown $jsonOut]
if {$success == 0} then {
    puts [CkPdf_lastErrorText $pdf]
    delete_CkPdf $pdf
    delete_CkJsonObject $json
    delete_CkStringBuilder $sbMarkdown
    delete_CkJsonObject $jsonOut
    exit
}

puts "---- default options ----"
puts [CkStringBuilder_getAsString $sbMarkdown]

#  Now change the options:

#  pageBreaks: "comment" (the default) separates pages with <!-- page N -->,
#  "rule" separates them with a horizontal rule (---), and "none" runs the pages together.
CkJsonObject_UpdateString $json "pageBreaks" "rule"

#  images: "placeholder" (the default) marks where each image sits with ![image](page-1-image-1);
#  "none" leaves images out.
CkJsonObject_UpdateString $json "images" "none"

#  tables: "ruled" (the default) converts tables that have drawn cell borders into Markdown tables;
#  "none" returns their cells as plain text.
CkJsonObject_UpdateString $json "tables" "none"

#  emphasis: false leaves out the ** and * markers for bold and italic.
CkJsonObject_UpdateBool $json "emphasis" 0

#  maxHeadingLevel: inferred headings deeper than this level are folded into this level.
#  The PDF has three heading levels; with maxHeadingLevel 2 the third level becomes ##.
CkJsonObject_UpdateInt $json "maxHeadingLevel" 2

CkStringBuilder_Clear $sbMarkdown
set success [CkPdf_ExtractTextSb $pdf "markdown" $json $sbMarkdown $jsonOut]
if {$success == 0} then {
    puts [CkPdf_lastErrorText $pdf]
    delete_CkPdf $pdf
    delete_CkJsonObject $json
    delete_CkStringBuilder $sbMarkdown
    delete_CkJsonObject $jsonOut
    exit
}

puts "---- custom options ----"
puts [CkStringBuilder_getAsString $sbMarkdown]

#  Sample output:

#  ---- default options ----
#  <!-- page 1 -->
#  
#  # Community Garden Handbook
#  
#  ## Plots
#  
#  ### Plot Sizes
#  
#  Plots come in two sizes. A **full plot** is twenty feet by ten feet; a **half plot** is ten feet square. New gardeners are *strongly encouraged* to start with a half plot.
#  
#  ![image](page-1-image-1)
#  
#  ### Plot Fees
#  
#  | Plot | Size | Annual Fee |
#  | --- | --- | --- |
#  | Full | 20 x 10 ft | $60 |
#  | Half | 10 x 10 ft | $35 |
#  
#  <!-- page 2 -->
#  
#  ## Watering
#  
#  ### Schedule
#  
#  The shared tanks are filled on Monday and Thursday mornings. Please water by hand from the tanks rather than running a hose from the street tap, which is metered.
#  
#  ### Dry Spells
#  
#  During a declared drought the committee may limit watering to **two days a week**. Notices are posted on the shed door and sent by e-mail.
#  
#  ---- custom options ----
#  # Community Garden Handbook
#  
#  ## Plots
#  
#  ## Plot Sizes
#  
#  Plots come in two sizes. A full plot is twenty feet by ten feet; a half plot is ten feet square. New gardeners are strongly encouraged to start with a half plot.
#  
#  ## Plot Fees
#  
#  Plot Size Annual Fee
#  
#  Full 20 x 10 ft $60
#  
#  Half 10 x 10 ft $35
#  
#  ---
#  
#  ## Watering
#  
#  ## Schedule
#  
#  The shared tanks are filled on Monday and Thursday mornings. Please water by hand from the tanks rather than running a hose from the street tap, which is metered.
#  
#  ## Dry Spells
#  
#  During a declared drought the committee may limit watering to two days a week. Notices are posted on the shed door and sent by e-mail.

delete_CkPdf $pdf
delete_CkJsonObject $json
delete_CkStringBuilder $sbMarkdown
delete_CkJsonObject $jsonOut