https://github.com/frangio/markup-split

✂️ Split a file into many parts.
https://github.com/frangio/markup-split

Last synced: about 1 month ago
JSON representation

✂️ Split a file into many parts.

• Host: GitHub
• URL: https://github.com/frangio/markup-split
• Owner: frangio
• Created: 2019-11-26T04:22:44.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2021-06-11T18:19:04.000Z (over 3 years ago)
• Last Synced: 2024-10-16T10:21:25.804Z (2 months ago)
• Language: TypeScript
• Homepage:
• Size: 315 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# markup-split ✂️

**Split a file into many parts.**

## Usage

```

markup-split [--force|-f] [--no-adjust|-A] [FILE...]

```

The supported file formats are AsciiDoc (`*.adoc`) and Markdown (`*.md`).

The input files will be scanned for `markup-split` directives (see Syntax below), and the contents that follow each directive will be copied to new files at the specified paths.

Use `--force` to overwrite existing files.

Use `--no-adjust` to disable decrementing heading levels.

## Syntax

The directives are written in comments, and have the form `markup-split: [PATH]`.

### Markdown

```markdown

# Introduction

<-- markup-split: part-1.md -->

## Part 1

<-- markup-split: part-2.md -->

## Part 2

```

### AsciiDoc

```asciidoc

= Introduction

// markup-split: part-1.adoc

== Part 1

// markup-split: part-2.adoc

== Part 2

```