Markdown Padding

English | 简体中文

A tool for formatting Markdown content with padding.

• Ensures consistent spacing before and after Markdown elements like headings, lists, and code blocks.
• Aligns tables by formatting column spacing properly.
• Supports formatting inside code blocks and recognizes mathematical expressions, HTML elements, YAML front matter, and fenced code blocks for correct formatting.
• Applies an extended AST parsing to ensure natural language structures like punctuations and latin characters are padded correctly.

Here's a change made by md-padding:

- # 如何中ArchLinux中安装X11？
+ # 如何中 ArchLinux 中安装 X11？

- 首先要安装ArchLinux，然后安装`xorg-server`软件包：
+ 首先要安装 ArchLinux，然后安装 `xorg-server` 软件包：

- 确保你的xorg-server版本已经足够高，比如>=1.20，然后安装**合适**的驱动：
+ 确保你的 xorg-server 版本已经足够高，比如 >= 1.20，然后安装 **合适** 的驱动：

- 如果你需要3D加速等新的功能，可能还需要安装*闭源驱动*。详情请参考[ArchWiki里的对应章节](https://wiki.archlinux.org/index.php/Xorg)。
+ 如果你需要 3D 加速等新的功能，可能还需要安装 *闭源驱动*。详情请参考 [ArchWiki 里的对应章节](https://wiki.archlinux.org/index.php/Xorg)。

Command Line Interface

npx md-padding -i README.md   # fix the file in place
npx md-padding README.md      # output the fixed content

For more options:

> npx md-padding --help
md-padding [OPTION]... <FILE>

Options:
  --help, -h      Show help                  [boolean]
  --version       Show version number        [boolean]
  --in-place, -i  Edit file in place         [boolean]
  --ignore-words, -I  Ignore padding for specific words  [string]
  --ignore-patterns, -P  Ignore specific patterns using regex  [string]
  --read-files, -r    Read file list from input, one file per line  [string]

Examples:
  stdout    md-padding README.md
  in-place  md-padding -i README.md
  pipe      cat README.md | md-padding
  ignore-words  cat README.md | md-padding -I '=' '::'
  ignore-patterns  cat README.md | md-padding -P '=' ':+'
  batch format  cat list.txt | md-padding -r -i
  equivalent w/ md-padding -r list.txt -i

Vim Integration

Map the F6 key to format Markdown files:

" Hotkey for md-padding format
noremap <buffer> <F6> <Esc>:%!npx md-padding<CR>

VS Code Integration

Install the Markdown Padding extension.

• Open Command Palette (Ctrl + Shift + P on Windows/Linux, Cmd + Shift + P on macOS) and run Markdown Padding.
• Use the default formatting shortcut:
  • Shift + Alt + F (Windows)
  • Shift + Option + F (Mac)
  • Ctrl + Shift + I (Linux)

Configuration

Setting	Type	Description
mdpadding.ignoreWords	Array<string>	Words to exclude from padding adjustments
mdpadding.ignorePatterns	Array<string>	Regular expressions defining patterns to ignore

Q&A

How to ignore a specific section

You can exclude certain sections from formatting using the md-padding-ignore directive:

Some text before the ignored section.
<!--md-padding-ignore-begin-->
a*b=c, b>1 => a&lt;c
<!--md-padding-ignore-end-->
This text will be formatted as usual.