NAME

Text::Textile2MarkdownStandalone - Standalone converter from Textile markup to Markdown

VERSION

version 0.11

SYNOPSIS

use Text::Textile2MarkdownStandalone;

# Convert a Textile file to a Markdown file
my $converter = Text::Textile2MarkdownStandalone->new(
  input_file  => 'input.textile',
  output_file => 'output.md',
);
$converter->convert;

# Get the Markdown output as a string
my $markdown = Text::Textile2MarkdownStandalone->new(
  input_file => 'input.textile'
)->convert;

DESCRIPTION

Text::Textile2MarkdownStandalone provides a simple, standalone tool to convert Textile-formatted text into Markdown. It supports:

Module rename history:

Originally released as Text-Textile2MarcdownStandalone (typo in Marcdown). Renamed to Text-Textile2MarkdownStandalone in version 0.03 to correct the typo and improve clarity.

• • Headings (h1-h6)
• Ordered and unordered lists with nesting
• Emphasis, strong emphasis, and strikethrough
• Code spans and code blocks
• Blockquotes
• Links and images
• Tables, including cells spanning multiple lines
• Horizontal rules and URL protection

METHODS

• new(%options)

  Create a new converter object. Options:

    input_file  => path to the input Textile file
    output_file => path to write the output Markdown file
                    (if omitted, convert() returns the Markdown string)
  

• input_file([$file])

  Get or set the input file path.

• output_file([$file])

  Get or set the output file path.

• convert

  Execute the conversion. Reads the input file, converts its content to Markdown, and either writes it to the output file or returns it as a string.

cli

Use the helper script included with this distribution to run from the command line:

perl script/textile2markdown.pl --input input.textile --output output.md

If only an input file is provided, the Markdown output will be printed to STDOUT.

AUTHOR

Akihito Takeda takeda.akihito@gmail.com

COPYRIGHT AND LICENSE

Copyright (C) 2025 Akihito Takeda

This software is free software; you may redistribute it and/or modify it under the same terms as Perl itself.