Page cover image

Markdown Text Splitting

Splits one Markdown file Into multiple by heading
  • Automation
Created
May 6, 2021 10:01 AM
Description
Splits one Markdown file Into multiple by heading
Last Edited
Jan 27, 2022 06:36 AM
Tags
Automation

Code

Split by H1 (#)

csplit --prefix='note' --suffix-format='%02d.md' --elide-empty-files notes.md '/^#\s.*/' '{*}'

Use Pandoc to shift headings by one level

find ./ -iname "*.md" -type f -exec sh -c 'pandoc  --shift-heading-level-by=-1 --wrap=preserve "${0}" -o "${0}"' {} \;

Parameters

--prefix
'/^#\s.*/'
prefix for output file name
Matches H1

Use Case

Source

Pandoc User's Guide
Pandoc is a Haskell library for converting from one markup format to another, and a command-line tool that uses this library. Pandoc can convert between numerous markup and word processing formats, including, but not limited to, various flavors of Markdown, HTML, LaTeX and Word docx.
https://pandoc.org/MANUAL.html#option--shift-heading-level-by
csplit(1) - Linux manual page
CSPLIT(1) User Commands CSPLIT(1) csplit - split a file into sections determined by context lines Output pieces of FILE separated by PATTERN(s) to files 'xx00', 'xx01', ..., and output byte counts of each piece to standard output. Read standard input if FILE is - Mandatory arguments to long options are mandatory for short options too.
https://man7.org/linux/man-pages/man1/csplit.1.html
csplit(1) - Linux manual page