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

Сделать Markdown-таблицу из CSV

Преобразует CSV в аккуратную таблицу Markdown, экранирует вертикальные черты и выравнивает числа.

PowerShell Windows Новичок
Скачать Csv-To-Markdown.ps1
Описание

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

Скрипт читает CSV через Import-Csv, определяет числовые колонки и ставит для них правое выравнивание. Символы pipe и переводы строк внутри ячеек заменяются безопасными вариантами. Таблица выводится на экран или сохраняется в файл Markdown.

Запуск

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

powershell -File Csv-To-Markdown.ps1 -Path .\report.csv -Output report.md

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

Примеры

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

  • powershell -File Csv-To-Markdown.ps1 -Path .\report.csv
  • powershell -File Csv-To-Markdown.ps1 -Path .\data.csv -Delimiter ';' -Output table.md
  • powershell -File Csv-To-Markdown.ps1 -Path .\export.csv -Output README.md
Зависимости

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

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

Csv-To-Markdown.ps1

[CmdletBinding()]
param(
    [Parameter(Mandatory = $true)]
    [string]$Path,
    [string]$Output,
    [char]$Delimiter = ','
)

$ErrorActionPreference = 'Stop'
$resolved = Resolve-Path -LiteralPath $Path -ErrorAction Stop
$rows = @(Import-Csv -LiteralPath $resolved -Delimiter $Delimiter)
if ($rows.Count -eq 0) {
    throw 'CSV не содержит строк'
}

$headers = @($rows[0].PSObject.Properties.Name)
function Escape-Cell([object]$Value) {
    if ($null -eq $Value) { return '' }
    $text = [string]$Value
    $text = $text.Replace('|', '\|')
    $text = $text.Replace("`r", ' ')
    $text = $text.Replace("`n", '<br>')
    return $text.Trim()
}

$headerLine = '| ' + (($headers | ForEach-Object { Escape-Cell $_ }) -join ' | ') + ' |'
$alignCells = foreach ($header in $headers) {
    $values = @($rows | ForEach-Object { $_.$header } | Where-Object { $null -ne $_ -and ([string]$_).Trim() -ne '' })
    $numeric = $values.Count -gt 0
    foreach ($value in $values) {
        if ([string]$value -notmatch '^-?\d+([.,]\d+)?$') {
            $numeric = $false
            break
        }
    }
    if ($numeric) { '---:' } else { '---' }
}
$alignLine = '| ' + ($alignCells -join ' | ') + ' |'

$lines = New-Object System.Collections.Generic.List[string]
$lines.Add($headerLine)
$lines.Add($alignLine)
foreach ($row in $rows) {
    $cells = foreach ($header in $headers) { Escape-Cell $row.$header }
    $lines.Add('| ' + ($cells -join ' | ') + ' |')
}

$markdown = ($lines -join [Environment]::NewLine) + [Environment]::NewLine
if ($Output) {
    $target = [IO.Path]::GetFullPath($Output)
    if ($target -eq $resolved.Path) { throw 'Выходной файл совпадает с входным' }
    [IO.File]::WriteAllText($target, $markdown, (New-Object System.Text.UTF8Encoding($false)))
    Write-Host "Таблица сохранена: $target"
} else {
    Write-Output $markdown
}

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

CLI 1.0.0

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

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

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

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

Категория

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

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