Global Configuration

/**
 * Set a global option
 * @param key - Option name
 * @param value - Option value
 * @returns showdown object for chaining
 */
showdown.setOption(key: string, value: any): showdown

// Enable strikethrough globally
showdown.setOption('strikethrough', true);

// Set header prefix globally
showdown.setOption('prefixHeaderId', 'section-');

// All new converters will inherit these settings
const converter1 = new showdown.Converter();
const converter2 = new showdown.Converter();

/**
 * Get a global option value
 * @param key - Option name
 * @returns Option value
 */
showdown.getOption(key: string): any

// Set and get an option
showdown.setOption('tables', true);
const tablesEnabled = showdown.getOption('tables');
console.log(tablesEnabled); // true

// Check if an option is set
const headerIdPrefix = showdown.getOption('prefixHeaderId');
if (headerIdPrefix) {
  console.log('Header IDs will be prefixed with:', headerIdPrefix);
}

/**
 * Get all global options
 * @returns Object containing all global options
 */
showdown.getOptions(): ConverterOptions

// Get all current global options
const globalOptions = showdown.getOptions();
console.log(globalOptions);

// Check multiple options
const options = showdown.getOptions();
if (options.tables && options.strikethrough) {
  console.log('Both tables and strikethrough are enabled');
}

// Create converter with modified global options
const customOptions = { ...showdown.getOptions(), emoji: true };
const converter = new showdown.Converter(customOptions);

/**
 * Reset global options to default values
 */
showdown.resetOptions(): void

// Set some global options
showdown.setOption('tables', true);
showdown.setOption('strikethrough', true);
showdown.setOption('emoji', true);

// Reset to defaults
showdown.resetOptions();

// All options are now back to default values
const options = showdown.getOptions();
console.log(options.tables); // false (default)
console.log(options.strikethrough); // false (default)

/**
 * Get the default options
 * @param simple - If true, returns simplified format
 * @returns Default options object
 */
showdown.getDefaultOptions(simple?: boolean): ConverterOptions

// Get default options in detailed format
const defaultOptions = showdown.getDefaultOptions();
console.log(defaultOptions);

// Get default options in simple format
const simpleDefaults = showdown.getDefaultOptions(true);
console.log(simpleDefaults);

// Compare current options with defaults
const currentOptions = showdown.getOptions();
const defaults = showdown.getDefaultOptions(true);

Object.keys(defaults).forEach(key => {
  if (currentOptions[key] !== defaults[key]) {
    console.log(`${key} changed from ${defaults[key]} to ${currentOptions[key]}`);
  }
});

// Set global options
showdown.setOption('tables', true);
showdown.setOption('strikethrough', true);

// New converter inherits global options
const converter1 = new showdown.Converter();
console.log(converter1.getOption('tables')); // true

// But can be overridden locally
const converter2 = new showdown.Converter({ tables: false });
console.log(converter2.getOption('tables')); // false

// Global options unchanged
console.log(showdown.getOption('tables')); // true

// Boolean options accept truthy/falsy values
showdown.setOption('tables', 1); // Treated as true
showdown.setOption('tables', ''); // Treated as false

// String options accept any value
showdown.setOption('prefixHeaderId', 'my-prefix-');

// Invalid option names are accepted but ignored
showdown.setOption('nonExistentOption', true);