https://github.com/teneplaysofficial/markdom
A Markdown and HTML parser for Node.js with TOC generation and anchor support.
https://github.com/teneplaysofficial/markdom
cli javascript markdown markdown-parser nodejs npm-package parser rollup typescript vitest
Last synced: about 1 year ago
JSON representation
A Markdown and HTML parser for Node.js with TOC generation and anchor support.
- Host: GitHub
- URL: https://github.com/teneplaysofficial/markdom
- Owner: TenEplaysOfficial
- License: mit
- Created: 2025-04-09T21:44:45.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-12T23:38:42.000Z (about 1 year ago)
- Last Synced: 2025-04-13T00:24:35.230Z (about 1 year ago)
- Topics: cli, javascript, markdown, markdown-parser, nodejs, npm-package, parser, rollup, typescript, vitest
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/@tenedev/markdom
- Size: 37.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Markdom
[](https://www.npmjs.com/package/@tenedev/markdom)
[](https://www.npmjs.com/package/@tenedev/markdom)
[](https://github.com/TenEplaysOfficial/markdom/pulls)
[](https://github.com/TenEplaysOfficial/markdom)
[](https://github.com/TenEplaysOfficial/markdom/issues)
[](https://github.com/TenEplaysOfficial/markdom)
`@tenedev/markdom` is a **Markdown parser** for Node.js that effortlessly converts **Markdown** files into **HTML** with automatic **Table of Contents (TOC)** generation, heading anchors, and more. Whether you’re building docs, wikis, or simply rendering Markdown to HTML, Markdom makes it easy to transform your Markdown into a beautiful, navigable HTML structure.
## 🚀 Key Features
- **📄 Markdown to HTML Parsing**: Converts Markdown to clean HTML, maintaining the original structure and formatting.
- **📑 Table of Contents (TOC)**: Automatically generates a TOC based on your Markdown headings.
- **🔗 Anchor Links for Headings**: Creates clickable anchor links for each heading, making navigation seamless.
- **🎨 Customizable**: Tailor the HTML and TOC generation to fit your needs.
- **🖥️ CLI Support**: Use the built-in CLI to quickly parse Markdown files and output HTML to a file.
## 🗂️ Table of Contents
- [Markdom](#markdom)
- [🚀 Key Features](#-key-features)
- [🗂️ Table of Contents](#️-table-of-contents)
- [🛠️ Installation](#️-installation)
- [Using `npm`:](#using-npm)
- [Using `yarn`:](#using-yarn)
- [📋 Prerequisites](#-prerequisites)
- [🧑💻 How to Use](#-how-to-use)
- [Node.js API](#nodejs-api)
- [`markdom.parse` function returns:](#markdomparse-function-returns)
- [📡 Command-Line Interface (CLI)](#-command-line-interface-cli)
- [🛠️ API Documentation](#️-api-documentation)
- [`markdom.parse(md: string): { html: string, toc: TOC[] }`](#markdomparsemd-string--html-string-toc-toc-)
- [🗂️ Table of Contents (TOC) Generation](#️-table-of-contents-toc-generation)
- [Resulting TOC:](#resulting-toc)
- [Rendering of Headings](#rendering-of-headings)
- [💻 Example Output](#-example-output)
- [Input (Markdown):](#input-markdown)
- [Output (HTML):](#output-html)
- [🤝 Contributing](#-contributing)
- [📜 License](#-license)
## 🛠️ Installation
To get started with `@tenedev/markdom`, install it using your preferred package manager:
### Using `npm`:
```bash
npm install @tenedev/markdom
```
### Using `yarn`:
```bash
yarn add @tenedev/markdom
```
---
## 📋 Prerequisites
- **Node.js** version 16.x or higher
- Basic familiarity with **Markdown syntax**
---
## 🧑💻 How to Use
### Node.js API
Import `@tenedev/markdom` into your project and start converting Markdown to HTML:
```ts
import { markdom } from '@tenedev/markdom';
// Example usage
const markdown = `# Example Heading\n\nThis is a sample markdown document.`;
const { html, toc } = markdom.parse(markdown);
console.log(html);
console.log(toc);
```
#### `markdom.parse` function returns:
- `html`: The generated HTML content.
- `toc`: An array of Table of Contents items, each containing:
- `id`: Slugified heading ID
- `title`: The heading text
- `level`: Heading level (e.g., 1 for H1, 2 for H2, etc.)
---
### 📡 Command-Line Interface (CLI)
You can also use the powerful CLI provided by `@tenedev/markdom` to convert Markdown files directly from the terminal.
1. **Basic Usage**:
```bash
npx @tenedev/markdom
```
2. **With Output Option**:
```bash
npx @tenedev/markdom -o output.html
```
> **Note**: The `-o` option supports only `.html` or `.htm` extensions. Other file types will trigger an error.
---
## 🛠️ API Documentation
### `markdom.parse(md: string): { html: string, toc: TOC[] }`
**Parameters**:
- `md` (string): The input Markdown string to be parsed.
**Returns**:
- `html` (string): The resulting HTML content after parsing.
- `toc` (array): An array representing the Table of Contents, with each item containing:
- `id` (string): A slugified version of the heading.
- `title` (string): The title of the heading.
- `level` (number): The level of the heading (1 for H1, 2 for H2, etc.).
---
## 🗂️ Table of Contents (TOC) Generation
The Table of Contents (TOC) is automatically generated and inserted at the `` comment in your Markdown. For example:
```markdown
# Heading 1
Some content.
## Heading 2
More content.
```
### Resulting TOC:
```html
```
### Rendering of Headings
Markdown headings automatically receive anchor links for easy navigation:
```markdown
# Heading 1
```
This is rendered as:
```html
🔗 Heading 1
```
---
## 💻 Example Output
### Input (Markdown):
```markdown
# Introduction
This is a Markdown document.
## Subheading 1
Details about subheading 1.
## Subheading 2
Details about subheading 2.
```
### Output (HTML):
```html
Markdown Output - @tenedev/markdom
🔗 Introduction
This is a Markdown document.
🔗 Subheading 1
Details about subheading 1.
🔗 Subheading 2
Details about subheading 2.
```
## 🤝 Contributing
We welcome contributions from the community!
If you have ideas, suggestions, or bug reports, feel free to [open an issue](https://github.com/TenEplaysOfficial/markdom/issues) or [submit a pull request](https://github.com/TenEplaysOfficial/markdom/pulls) on GitHub.
Let's make `@tenedev/markdom` better together!
## 📜 License
This project is licensed under the [MIT License](LICENSE).
Copyright © [TenEplaysOfficial](https://github.com/TenEplaysOfficial)