{"id":15661938,"url":"https://github.com/nvuillam/markdown-table-formatter","last_synced_at":"2025-12-27T16:07:09.164Z","repository":{"id":44693803,"uuid":"329341199","full_name":"nvuillam/markdown-table-formatter","owner":"nvuillam","description":"Check markdown tables formatting and apply fixes","archived":false,"fork":false,"pushed_at":"2024-10-29T22:51:35.000Z","size":764,"stargazers_count":23,"open_issues_count":4,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-30T03:53:29.296Z","etag":null,"topics":["formatter","markdown","markdown-table","megalinter","prettier","prettify","table"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nvuillam.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["nvuillam"]}},"created_at":"2021-01-13T14:56:56.000Z","updated_at":"2024-10-25T12:38:52.000Z","dependencies_parsed_at":"2023-11-28T20:29:02.117Z","dependency_job_id":"6b10c507-bc19-461e-bd51-32001cc86490","html_url":"https://github.com/nvuillam/markdown-table-formatter","commit_stats":{"total_commits":86,"total_committers":6,"mean_commits":"14.333333333333334","dds":0.5697674418604651,"last_synced_commit":"b6f5476efabf185c8ed68cdd86394cdd0c0b7e3f"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nvuillam%2Fmarkdown-table-formatter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nvuillam%2Fmarkdown-table-formatter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nvuillam%2Fmarkdown-table-formatter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nvuillam%2Fmarkdown-table-formatter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nvuillam","download_url":"https://codeload.github.com/nvuillam/markdown-table-formatter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247441059,"owners_count":20939239,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["formatter","markdown","markdown-table","megalinter","prettier","prettify","table"],"created_at":"2024-10-03T13:29:37.185Z","updated_at":"2025-12-27T16:07:09.158Z","avatar_url":"https://github.com/nvuillam.png","language":"JavaScript","readme":"\u003c!-- markdownlint-disable MD033 MD041 --\u003e\n\n# Markdown table formatter\n\n[![Version](https://img.shields.io/npm/v/markdown-table-formatter.svg)](https://npmjs.org/package/markdown-table-formatter)\n[![Downloads/week](https://img.shields.io/npm/dw/markdown-table-formatter.svg)](https://npmjs.org/package/markdown-table-formatter)\n[![Downloads/total](https://img.shields.io/npm/dt/markdown-table-formatter.svg)](https://npmjs.org/package/markdown-table-formatter)\n[![Mega-Linter](https://github.com/nvuillam/markdown-table-formatter/workflows/Mega-Linter/badge.svg)](https://github.com/nvuillam/mega-linter#readme)\u003c!-- gh-dependents-info-used-by-start --\u003e\n[![Generated by github-dependents-info](https://img.shields.io/static/v1?label=Used%20by\u0026message=92\u0026color=informational\u0026logo=slickpic)](https://github.com/nvuillam/markdown-table-formatter/blob/main/docs/github-dependents-info.md)\u003c!-- gh-dependents-info-used-by-end --\u003e\n[![codecov](https://codecov.io/gh/nvuillam/markdown-table-formatter/branch/master/graph/badge.svg)](https://codecov.io/gh/nvuillam/markdown-table-formatter)\n[![GitHub contributors](https://img.shields.io/github/contributors/nvuillam/markdown-table-formatter.svg)](https://gitHub.com/nvuillam/markdown-table-formatter/graphs/contributors/)\n[![GitHub stars](https://img.shields.io/github/stars/nvuillam/markdown-table-formatter?label=Star\u0026maxAge=2592000)](https://GitHub.com/nvuillam/markdown-table-formatter/stargazers/)\n[![License](https://img.shields.io/npm/l/markdown-table-formatter.svg)](https://github.com/nvuillam/markdown-table-formatter/blob/master/LICENSE)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n\nFormat markdown tables in files, using embedded [markdown-table-prettify](https://www.npmjs.com/package/markdown-table-prettify)\n\n[![Banner](https://raw.githubusercontent.com/nvuillam/markdown-table-formatter/master/docs/assets/images/banner.jpg)](https://github.com/nvuillam/markdown-table-formatter#readme)\n\n## Table of contents\n\n- [Installation](#installation)\n  - [Local](#local)\n  - [Global](#global)\n- [Usage](#usage)\n  - [Options](#options)\n- [Examples](#examples)\n- [Continuous Integration](#continuous-integration)\n- [Ignoring Code Blocks](#ignoring-code-blocks)\n- [Contribute](#contribute)\n- [Release notes](#release-notes)\n\n## Installation\n\n### Local\n\n```shell\nnpm install markdown-table-formatter --save\n```\n\n### Global\n\n```shell\nnpm install markdown-table-formatter -g\n```\n\n## Usage\n\n```shell\nmarkdown-table-formatter [OPTIONS] (file(s) or glob expression)\n```\n\n### Options\n\n| Parameter      | Description                       | Default value |\n|----------------|-----------------------------------|---------------|\n| -c\u003cbr/\u003e--check | Check only, does not update files | `false`       |\n| -p\u003cbr/\u003e--columnpadding   | Override column padding number of spaces |\n| -h\u003cbr/\u003e--help    | Displays help                     | \u003c!-- --\u003e      |\n| -v\u003cbr/\u003e--version | Displays version                  | \u003c!-- --\u003e      |\n\n## Examples\n\nFormat all markdown files found within current directory\n\n```shell\nmarkdown-table-formatter\n```\n\nFormat all markdown files found with a glob expression\n\n```shell\nmarkdown-table-formatter **/docs/*.md\n```\n\nFormat markdown tables in a single file\n\n```shell\nmarkdown-table-formatter myfile.md\n```\n\nFormat markdown tables in a multiple file\n\n```shell\nmarkdown-table-formatter myfile.md anotherFile.md andAnotherFile.md\n```\n\nCheck if markdown table formatting is necessary in a single file\n\n```shell\nmarkdown-table-formatter --check myfile.md\n```\n\nCheck if markdown table formatting is necessary in a multiple files\n\n```shell\nmarkdown-table-formatter --check myfile.md anotherFile.md andAnotherFile.md\n```\n\nYou can see **more examples in** [**test methods**](https://github.com/nvuillam/markdown-table-formatter/blob/master/test/markdown-table-formatter.test.js)\n\n## Continuous Integration\n\nYou can automatically check markdown tables formatting and fix it using [MegaLinter](https://github.com/oxsecurity/megalinter/), that embeds markdown-table-formatter out of the box\n\n## Ignoring Code Blocks\n\nYou may wish to ignore specific markdown content, especially when using with [Megalinter](https://github.com/oxsecurity/megalinter) or [terraform-docs](https://github.com/terraform-docs/terraform-docs)\n\nTo achieve this, place tags `\u003c!-- markdown-table-prettify-ignore-start --\u003e` and `\u003c!-- markdown-table-prettify-ignore-end --\u003e` around the content you want markdown-table-formatter to ignore.\n\n## Contribute\n\nContributions are very welcome !\n\nPlease follow [Contribution instructions](https://github.com/nvuillam/markdown-table-formatter/blob/master/CONTRIBUTING.md)\n\n## Release Notes\n\nSee complete [CHANGELOG](https://github.com/nvuillam/markdown-table-formatter/blob/master/CHANGELOG.md)\n","funding_links":["https://github.com/sponsors/nvuillam"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnvuillam%2Fmarkdown-table-formatter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnvuillam%2Fmarkdown-table-formatter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnvuillam%2Fmarkdown-table-formatter/lists"}