Данные и таблицы

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

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

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

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

PowerShell-скрипт читает CSV через Import-Csv, берёт заголовок и формирует таблицу для README или документации. Можно ограничить число строк флагом -MaxRows. Символ вертикальной черты и переводы строк внутри ячеек экранируются, чтобы таблица не ломалась.

Перед запуском
  • Для очень широких таблиц Markdown может читаться плохо. Ограничьте число колонок заранее.
Запуск

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

powershell -File Csv-ToMarkdown.ps1 -Path data.csv -OutFile data.md

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

Примеры

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

  • powershell -File Csv-ToMarkdown.ps1 -Path .\data.csv -MaxRows 20
  • powershell -File Csv-ToMarkdown.ps1 -Path .\report.csv -OutFile .\docs\report.md -Force
Зависимости

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

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

Csv-ToMarkdown.ps1

[CmdletBinding()]
param(
    [Parameter(Mandatory = $true)]
    [string]$Path,
    [string]$OutFile = '',
    [ValidateRange(0, 1000000)]
    [int]$MaxRows = 0,
    [switch]$Force
)

$ErrorActionPreference = 'Stop'

if (-not (Test-Path -LiteralPath $Path -PathType Leaf)) {
    throw "Файл не найден: $Path"
}
$resolved = (Resolve-Path -LiteralPath $Path).Path
if ([string]::IsNullOrWhiteSpace($OutFile)) {
    $OutFile = [System.IO.Path]::ChangeExtension($resolved, '.md')
}
if ([System.IO.Path]::IsPathRooted($OutFile)) {
    $outFull = [System.IO.Path]::GetFullPath($OutFile)
} else {
    $outFull = [System.IO.Path]::GetFullPath((Join-Path (Get-Location).Path $OutFile))
}
if ($resolved -eq $outFull) {
    throw "Выходной файл не должен совпадать с исходным"
}
if (Test-Path -LiteralPath $outFull) {
    if (-not $Force) {
        throw "Файл уже существует: $outFull. Добавьте -Force"
    }
}

$rows = @(Import-Csv -LiteralPath $resolved)
if ($rows.Count -eq 0) {
    throw "В CSV нет строк данных"
}
$columns = @($rows[0].PSObject.Properties.Name)
if ($MaxRows -gt 0) {
    $selected = @($rows | Select-Object -First $MaxRows)
} else {
    $selected = $rows
}

function Escape-Cell {
    param([string]$Value)
    if ($null -eq $Value) { return '' }
    $text = [string]$Value
    $text = $text -replace '\|', '\|'
    $text = $text -replace '\r?\n', '<br>'
    return $text
}

$builder = New-Object System.Text.StringBuilder
[void]$builder.AppendLine('| ' + (($columns | ForEach-Object { Escape-Cell $_ }) -join ' | ') + ' |')
[void]$builder.AppendLine('| ' + (($columns | ForEach-Object { '---' }) -join ' | ') + ' |')
foreach ($row in $selected) {
    $cells = foreach ($column in $columns) {
        Escape-Cell ([string]$row.$column)
    }
    [void]$builder.AppendLine('| ' + ($cells -join ' | ') + ' |')
}

$text = $builder.ToString()
$encoding = New-Object System.Text.UTF8Encoding($false)
[System.IO.File]::WriteAllText($outFull, $text, $encoding)

Write-Host "Строк: $($selected.Count) из $($rows.Count)"
Write-Host "Колонок: $($columns.Count)"
Write-Host "Результат: $outFull"

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

CLI 1.0.0

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

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

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

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

Категория

Данные и таблицы

CSV, JSON, SQLite, Excel, очистка, объединение и отчёты.