Skip to main content

Markdown to HTML

Converts Markdown content to HTML format using the gomarkdown library.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Markdown Content - Markdown text to convert to HTML. Can be provided directly as text, from a file, or from a URL depending on the Input Mode setting.

Options​

  • Input Mode - Choose the source for Markdown content:
    • Text - Markdown content is provided directly in the input field
    • File - Markdown content is read from a file at the specified path
    • URL - Markdown content is fetched from a web URL
  • Output Mode - Choose the destination for converted HTML:
    • Text - HTML is returned as output
    • File - HTML is saved to a file at the specified path
  • Output File Path - File path to save HTML when Output Mode is File
  • Proxy Settings - Configure proxy for URL-based requests:
    • No Proxy - Direct connection
    • Manual Proxy - Use specified proxy address
    • Robomotion Proxy - Use Robomotion's proxy service
  • Proxy Address - Proxy server address when using Manual Proxy
  • Proxy Authentication - Authentication method for proxy:
    • No Authentication - No authentication required
    • Basic Authentication - Username/password authentication
  • Proxy Credentials - Credentials for proxy authentication when using Basic Authentication
  • Skip TLS Verification - Skip SSL/TLS certificate verification for HTTPS connections

Output​

  • HTML - The converted HTML text from the Markdown input.

How It Works​

The Markdown to HTML node converts Markdown content to HTML format. When executed, the node:

  1. Retrieves the Markdown content based on the Input Mode setting:
    • Text mode: Uses the Markdown content provided directly
    • File mode: Reads Markdown content from the specified file path
    • URL mode: Fetches Markdown content from the provided URL
  2. Processes the Markdown through the gomarkdown library to convert it to HTML
  3. Outputs the converted HTML text
  4. If Output Mode is set to File, also saves the HTML to the specified file path

Requirements​

  • For File mode: Valid file path with readable Markdown content
  • For URL mode: Valid URL accessible from the execution environment
  • For proxy usage: Valid proxy configuration when needed

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid Markdown Content input
  • File does not exist when using File mode
  • Input path is a directory instead of a file
  • Unable to read file when using File mode
  • Unable to fetch URL when using URL mode
  • HTTP error when fetching URL
  • Unable to read response body from URL
  • Invalid proxy address format
  • Empty username or password for proxy authentication
  • Unable to write output file when using File mode

Usage Notes​

  • The node supports multiple input methods for flexibility
  • Proxy settings are only used when Input Mode is set to URL
  • When using URL mode, ensure the target server is accessible
  • File paths should be absolute or relative to the execution environment
  • Output file path will be created if it doesn't exist, but directory must exist
  • TLS verification should only be skipped in trusted environments