Metadata-Version: 2.1
Name: pandoc-docx-helper
Version: 0.0.1
Summary: Pandoc filter for docx output to insert pagebreak at will
Author: Mico Papp based on Kazuki Yamamotos work
Keywords: pandoc filter docx
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# pandoc-docx-pagebreak-py

Pandoc filter to insert page break or table-of-contents in docx file

### install

```bash
pip3 install git+https://github.com/pmamico/pandoc-docx-helper.git
```

### Usage

- Add `\newpage` where preferred to insert a page break
    - Expecting to work like native pandoc behavior for latex output
- Add `\toc` where preferred to insert TOC(Table of Contents)
    - unable to use with `--toc` otherwise TOC appears on head of document also
<!--
- Add `\newsection` where preferred to insert a section break
    - Only works for docx output
    - It resets page header/footer style to _portrait, US-letter_ sized pages with whatever reference file you used,
    except the last section in the file. **_You will have to fix them to your preference._**
-->

```bash
# Try the filter with this file like this:
pandoc -f markdown -t docx -o docx.docx --filter=pandoc-docx-pagebreakpy README.md
```

### Sample

```markdown
Table of contents appears after this line

\toc

Contents before pagebreak

\newpage

Contents after _Page Break_
```

Table of contents appears after this line

\toc

Contents before pagebreak

\newpage

Contents after _Page Break_
