Class: Commonmarker::Merge::SmartMerger

Inherits:

Markdown::Merge::SmartMerger

• Object
• Markdown::Merge::SmartMerger
• Commonmarker::Merge::SmartMerger

Defined in:

lib/commonmarker/merge/smart_merger.rb

Overview

Orchestrates the smart merge process for Markdown files using CommonMarker.

This is a thin wrapper around Markdown::Merge::SmartMerger that:

• Forces the :commonmarker backend
• Sets commonmarker-specific defaults (freeze token, inner_merge_code_blocks)
• Exposes commonmarker-specific options (options hash)

Examples:

Basic merge (destination customizations preserved)

merger = SmartMerger.new(template_content, dest_content)
result = merger.merge
if result.success?
  File.write("output.md", result.content)
end

Template updates win

merger = SmartMerger.new(
  template_content,
  dest_content,
  preference: :template,
  add_template_only_nodes: true
)
result = merger.merge

Custom signature matching

sig_gen = ->(node) {
  canonical_type = Ast::Merge::NodeTyping.merge_type_for(node) || node.type
  if canonical_type == :heading
    [:heading, node.header_level]  # Match by level only, not content
  else
    node  # Fall through to default
  end
}
merger = SmartMerger.new(
  template_content,
  dest_content,
  signature_generator: sig_gen
)

See Also:

• Underlying implementation