markmv - v1.41.7
    Preparing search index...

    Class BaseSplitStrategyAbstract

    Abstract base class for all split strategies.

    Provides common functionality for splitting markdown files including filename generation, frontmatter handling, and content sanitization. Concrete strategies implement specific splitting algorithms.

    Implementing a custom split strategy

      class CustomSplitStrategy extends BaseSplitStrategy {
        async split(content: string, originalFilename: string): Promise<SplitResult> {
          // Custom splitting logic
          const sections = this.customSplit(content);
          return { sections, remainingContent: undefined, errors: [], warnings: [] };
        }
      }

    Hierarchy (View Summary)

    Index
    constructor
    options
    extractFrontmatter extractTitleFromHeader generateFilename getHeaderLevel isTargetHeader sanitizeFilename split numberOrDefault stringOrDefault
    options: SplitStrategyOptions

    The effective options for this strategy: the supplied options layered over the defaults set in the constructor.

    • Separates a leading frontmatter block from the rest of the content.

      Parameters

      • content: string

        The full file content.

      Returns { content: string; frontmatter: string }

      The split content.

      • content: string

        The content following the frontmatter, or the whole input when there is none.

      • frontmatter: string

        The leading --- delimited block including its delimiters, or an empty string when there is none.

    • Extracts the title text from a header line.

      Parameters

      • headerLine: string

        A markdown header line.

      Returns string

      The text after the # markers, trimmed.

    • Generates a filename for a section from the filenamePattern option.

      {title} is replaced by the sanitised title (or section-N when that is empty), {index} by the one-based index and {original} by the original filename without its extension. The original file's extension is appended, defaulting to .md.

      Parameters

      • title: string

        The section title.

      • index: number

        The zero-based position of the section.

      • originalFilename: string

        The name of the file being split.

      Returns string

      The generated filename.

    • Returns the header level of a line.

      Parameters

      • line: string

        The line to inspect.

      Returns number

      The number of leading # characters when the line is a header (the markers followed by whitespace or the end of the line), otherwise 0.

    • Checks whether a line is a header of exactly the given level.

      Parameters

      • line: string

        The line to inspect.

      • targetLevel: number

        The header level to match.

      Returns boolean

      True when the line's header level equals targetLevel; headers of other levels do not match.

    • Converts a string into a filename-safe slug.

      The text is lower-cased, characters other than letters, digits, spaces and hyphens are removed, whitespace becomes hyphens, repeated and surrounding hyphens are collapsed, and the result is limited to 50 characters.

      Parameters

      • str: string

        The text to convert.

      Returns string

      The slug, which may be empty.

    • Divides content into sections that can each become their own file.

      Each concrete strategy decides where the split points are. Problems are reported in the result's errors and warnings rather than thrown.

      Parameters

      • content: string

        The full content of the file to split, including any frontmatter.

      • originalFilename: string

        The name of the file being split, used when generating section filenames.

      Returns Promise<SplitResult>

      The sections to create, the content to leave in the original file (the frontmatter when preserveFrontmatter is on), and any errors and warnings.

    • Returns value unless it is nullish or zero, in which case fallback is used, since zero is not a meaningful value for these options (header levels start at 1, size limits must be positive).

      Parameters

      • value: number | undefined
      • fallback: number

      Returns number

    • Returns value unless it is nullish or the empty string, in which case fallback is used, an empty string is treated as "no value supplied" rather than a meaningful value to preserve.

      Parameters

      • value: string | null | undefined
      • fallback: string

      Returns string

    Settings
    Member Visibility

    On This Page
    Constructors
    Properties
    Methods