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.