https://github.com/rafalkaron/markup
Batch-convert Markdown and HTML files.
https://github.com/rafalkaron/markup
batch-processing cli-app dita html5 markdown md python3
Last synced: about 1 month ago
JSON representation
Batch-convert Markdown and HTML files.
- Host: GitHub
- URL: https://github.com/rafalkaron/markup
- Owner: rafalkaron
- License: mit
- Created: 2019-12-07T13:10:08.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-08-31T20:53:25.000Z (almost 2 years ago)
- Last Synced: 2025-09-05T20:54:36.732Z (9 months ago)
- Topics: batch-processing, cli-app, dita, html5, markdown, md, python3
- Language: HTML
- Homepage:
- Size: 59.5 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MarkUP
Batch-convert Markdown and HTML files.
## Before you begin
1. Download the newest **MarkUP**. See [Download MarkUP](https://github.com/rafalkaron/MarkUP/releases/latest).
2. Unzip **MarkUP**.
## Convert documents
1. In terminal, enter `markup` followed by these parameters:
| Parameter | Required | Description |
|------------------------|----------|-------------------------------------------------------|
| **``** | Yes | Path to a file or directory containing files to convert. |
| **``** | Yes | One of the following conversion modes:
- `md_dita` - Converts Markdown to DITA.
- `html_dita` - Converts HTML to DITA.
- `md_html` - Converts Markdown to HTML.
- `html_md` - Converts HTML to Markdown.
| **`-out `** | No | Directory for the converted files (defaults to the input directory). |
2. If needed, accept any security prompts.
For more information, see [Accepting macOS Security Prompts](https://github.com/rafalkaron/MarkUP/wiki/Accepting-macOS-Security-Prompts) or [Accepting Windows Security Prompts](https://github.com/rafalkaron/MarkUP/wiki/Accepting-Windows-Security-Prompts).
## Examples
The following converts every Markdown file to DITA in the `Downloads` directory.
```zsh
markup "/Users/user_name/Downloads" md_dita
```
The following coverts the `README.html` file to DITA.
```zsh
markup "/Users/user_name/Desktop/README.html" html_dita
```
The following converts every Markdown file from the `Downloads` directory to HTML and saves the HTML files to the `Destkop` directory.
```zsh
markup "/Users/user_name/Downloads" md_html -out "/Users/user_name/Desktop/"
```