Markdown to TOML Converter

About Markdown to TOML Converter

Convert Markdown tables to TOML (Tom's Obvious, Minimal Language) configuration format. TOML is a minimal configuration file format that's easy to read and write, commonly used for application configuration files, package manifests, and data serialization.

Key Features

• Array of Tables: Generate [[table]] format for multiple records
• Inline Tables: Alternative format with inline table syntax
• Automatic Type Detection: Detects strings, integers, floats, booleans, and dates
• Custom Table Names: Specify your own table name
• Comment Support: Optional metadata comments
• Key Sanitization: Automatically formats valid TOML keys
• Special Character Escaping: Proper string escaping for TOML
• File Upload & Download: Easy import/export

How to Use

1. Input Markdown Table: Paste your Markdown table or upload a .md file
2. Configure Options: Set table name and format preferences
3. Review Output: The TOML format updates automatically
4. Copy or Download: Use the Copy button or download as .toml file
5. Use in Your Application: Import into your config files or applications

TOML Format Options

• Array of Tables ([[table]]): Each row becomes a separate table entry (recommended for multiple records)
• Inline Tables: Each row becomes an inline table within a single section

Type Detection

The converter automatically detects and formats values as:

• Strings: Text values in double quotes with proper escaping
• Integers: Whole numbers without quotes (e.g., 42, -17)
• Floats: Decimal numbers (e.g., 3.14, -0.01)
• Booleans: true/false values (case-insensitive in input)
• Dates: ISO 8601 format dates and datetimes

Example Conversion

Markdown Input:

| Name | Age | City | Active |
|------|-----|------|--------|
| John Doe | 28 | New York | true |
| Jane Smith | 34 | London | true |

TOML Output (Array of Tables):

# Generated from Markdown table
# Table: data
# Rows: 2

[[data]]
name = "John Doe"
age = 28
city = "New York"
active = true

[[data]]
name = "Jane Smith"
age = 34
city = "London"
active = true

Common Use Cases

• Configuration Files: Create app config files in TOML format
• Rust Projects: Generate Cargo.toml dependencies or data
• Python Projects: Create pyproject.toml configurations
• Hugo Sites: Generate front matter for static sites
• Package Manifests: Create package metadata files
• Data Serialization: Store structured data in human-readable format

TOML Compatibility

This converter generates TOML v1.0.0 compliant output that works with:

• Rust (Cargo.toml, serde)
• Python (pyproject.toml, toml library)
• Hugo static site generator
• Go applications (go-toml)
• Ruby (toml-rb gem)
• Any TOML v1.0.0 compliant parser

TOML Syntax Reference

• [table]: Table header
• [[array]]: Array of tables
• key = value: Key-value pair
• "string": String value with quotes
• 42: Integer value without quotes
• true/false: Boolean values
• #: Comment prefix

Advanced Features

• Nested Tables: Can be created manually with dot notation (table.subtable)
• Arrays: Supports array values with [value1, value2] syntax
• Multi-line Strings: Use triple quotes for long text
• Literal Strings: Single quotes for strings without escaping

Markdown Table Support

Supports GitHub Flavored Markdown (GFM) table syntax:

• Pipe-delimited columns
• Header separator line with dashes
• Optional column alignment indicators
• Leading and trailing pipes

Tips for Best Results

• Use descriptive table names that match your config structure
• Use "Array of Tables" format for multiple similar records
• Ensure boolean values are "true" or "false" for proper detection
• Use ISO 8601 format for dates (YYYY-MM-DD)
• Keep key names simple and lowercase for consistency
• Validate output with a TOML parser before using in production

Privacy & Security

All conversions happen locally in your browser. Your Markdown data is never uploaded to any server, ensuring complete privacy and security.