w
Documentation Core Tools Html To Markdown

Advanced Conversion Options

The HTML to Markdown converter offers several advanced features for fine-tuning your conversions:

Custom Conversion Rules

The tool uses the Turndown library with customizable rules for different HTML elements:

  • Inlined Links: [text](url) format
  • Reference Links: [text][ref] format with reference definitions
  • Link Preservation: Option to keep or remove links during conversion

Image Processing

  • Alt Text Preservation: Maintains image alt attributes
  • Source URL Handling: Preserves image source URLs
  • Image Format Support: Works with all standard image formats

Table Conversion

  • Header Detection: Automatically identifies table headers
  • Alignment Preservation: Maintains column alignment where possible
  • Complex Tables: Handles nested tables and complex structures

Code Block Processing

  • Language Detection: Identifies programming languages from CSS classes
  • Fenced Code Blocks: Uses triple backticks with language identifiers
  • Inline Code: Preserves inline code formatting

Output Format Options

Standard Markdown

  • Basic Markdown syntax
  • Compatible with most Markdown parsers
  • Clean, minimal formatting

GitHub Flavored Markdown (GFM)

  • Enhanced Markdown features
  • Table support
  • Strikethrough text
  • Task lists
  • Autolinks

Encoding Support

The tool supports multiple text encodings:

  • UTF-8: Full Unicode support
  • ASCII: Basic ASCII characters only
  • Latin-1: Extended Latin character set

Customization Features

Element Filtering

Choose which HTML elements to preserve during conversion:

  • Links and images
  • Tables and lists
  • Code blocks and inline code
  • Headings and paragraphs

Formatting Options

  • Heading Style: ATX style (# Heading) or Setext style
  • List Markers: Choose between -, *, or + for unordered lists
  • Code Block Style: Fenced or indented code blocks
  • Emphasis Delimiters: *italic* or _italic_

Advanced Settings

  • Line Break Handling: Preserve or normalize line breaks
  • Whitespace Management: Control spacing and indentation
  • Special Character Escaping: Handle special Markdown characters

Performance Optimization

Large Document Handling

  • Streaming Processing: Efficiently handles large HTML documents
  • Memory Management: Optimized for memory usage
  • Batch Processing: Support for multiple document conversion

Error Handling

  • Graceful Degradation: Continues processing even with malformed HTML
  • Error Reporting: Clear error messages for conversion issues
  • Fallback Options: Alternative conversion methods for problematic content

Integration Features

API Access

  • Programmatic Conversion: Use the conversion engine in your applications
  • Batch Processing: Convert multiple documents at once
  • Custom Rules: Define your own conversion rules

Export Options

  • Multiple Formats: Export to various Markdown flavors
  • Template Support: Use custom templates for output formatting
  • Metadata Preservation: Maintain document metadata during conversion

Tips for Best Results

  1. Clean Input: Remove unnecessary HTML attributes and styling
  2. Test Settings: Experiment with different options to find optimal results
  3. Review Output: Always check the preview before finalizing
  4. Use History: Save successful conversion settings for reuse
  5. Batch Processing: Use the history feature for multiple similar conversions
Was this page helpful?