Текст и документы

Выровнять уровни заголовков Markdown

Приводит заголовки к первому уровню и убирает пропуски между вложенными разделами.

PowerShell Windows Средний
Скачать Normalize-Headings.ps1
Описание

Что делает скрипт

Скрипт находит все заголовки вне блоков кода, вычисляет минимальный уровень и сдвигает шкалу так, чтобы документ начинался с первого уровня. Дополнительно запрещаются скачки через уровень, например с H1 сразу на H3. Результат можно вывести на экран, сохранить в файл или заменить исходник с копией .bak.

Перед запуском
  • Режим -InPlace меняет исходный файл, но оставляет копию .bak.
Запуск

Быстрый старт

powershell -File Normalize-Headings.ps1 -Path .\article.md -Output fixed.md

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. Запускайте в PowerShell 5.1 или PowerShell 7.

Примеры

Другие варианты

  • powershell -File Normalize-Headings.ps1 -Path .\article.md
  • powershell -File Normalize-Headings.ps1 -Path .\article.md -Output fixed.md
  • powershell -File Normalize-Headings.ps1 -Path .\article.md -InPlace
Зависимости

Что понадобится

PowerShell 5.1+ Встроен в Windows 10 и 11
Windows Встроен в Windows 10/11 (PowerShell 5.1)
Исходник

Normalize-Headings.ps1

[CmdletBinding()]
param(
    [Parameter(Mandatory = $true)]
    [string]$Path,
    [string]$Output,
    [switch]$InPlace
)

$ErrorActionPreference = 'Stop'
$resolved = Resolve-Path -LiteralPath $Path -ErrorAction Stop
if (-not (Test-Path -LiteralPath $resolved -PathType Leaf)) {
    throw "Укажите файл: $resolved"
}
if ($Output -and $InPlace) {
    throw 'Флаги -Output и -InPlace несовместимы'
}
if ($Output -and [IO.Path]::GetFullPath($Output) -eq $resolved.Path) {
    throw 'Выходной файл совпадает с входным, используйте -InPlace'
}

$lines = @(Get-Content -LiteralPath $resolved -Encoding UTF8)
$inFence = $false
$levels = New-Object System.Collections.Generic.List[int]
foreach ($line in $lines) {
    if ($line -match '^\s*(```|~~~)') {
        $inFence = -not $inFence
        continue
    }
    if ($inFence) { continue }
    if ($line -match '^(#{1,6})\s+(.+)$') {
        $levels.Add($matches[1].Length)
    }
}
if ($levels.Count -eq 0) {
    throw 'Заголовки Markdown не найдены'
}

$minimum = ($levels | Measure-Object -Minimum).Minimum
$shift = $minimum - 1
$previous = 0
$result = New-Object System.Collections.Generic.List[string]
$inFence = $false
$changed = 0

foreach ($line in $lines) {
    if ($line -match '^\s*(```|~~~)') {
        $inFence = -not $inFence
        $result.Add($line)
        continue
    }
    if (-not $inFence -and $line -match '^(#{1,6})\s+(.+)$') {
        $level = $matches[1].Length - $shift
        if ($level -lt 1) { $level = 1 }
        if ($level -gt $previous + 1) { $level = $previous + 1 }
        $previous = $level
        $prefix = ('#' * $level) -join ''
        $updated = $prefix + ' ' + $matches[2]
        if ($updated -ne $line) { $changed++ }
        $result.Add($updated)
        continue
    }
    $result.Add($line)
}

$text = ($result -join [Environment]::NewLine) + [Environment]::NewLine
if ($InPlace) {
    $backup = $resolved.Path + '.bak'
    Copy-Item -LiteralPath $resolved.Path -Destination $backup -Force
    [IO.File]::WriteAllText($resolved.Path, $text, (New-Object System.Text.UTF8Encoding($false)))
    Write-Host "Файл обновлён, копия: $backup"
} elseif ($Output) {
    $target = [IO.Path]::GetFullPath($Output)
    [IO.File]::WriteAllText($target, $text, (New-Object System.Text.UTF8Encoding($false)))
    Write-Host "Результат: $target"
} else {
    Write-Output $text
}
Write-Host "Заголовков: $($levels.Count), изменено строк: $changed"

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get text-heading-levels
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Текст и документы

Поиск, замена, кодировки, Markdown, CSV и работа с большими текстами.