Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zuchka/remove-markdown
Strip Markdown stuff from text
https://github.com/zuchka/remove-markdown
javascript markdown nodejs
Last synced: about 2 months ago
JSON representation
Strip Markdown stuff from text
- Host: GitHub
- URL: https://github.com/zuchka/remove-markdown
- Owner: zuchka
- License: mit
- Created: 2015-02-15T06:59:23.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2024-07-19T00:51:39.000Z (2 months ago)
- Last Synced: 2024-07-23T11:56:42.026Z (about 2 months ago)
- Topics: javascript, markdown, nodejs
- Language: JavaScript
- Size: 120 KB
- Stars: 302
- Watchers: 5
- Forks: 58
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-nodejs - remove-markdown - Strip Markdown stuff from text. ![](https://img.shields.io/github/stars/stiang/remove-markdown.svg?style=social&label=Star) (Repository / Parsing)
- project-awesome - zuchka/remove-markdown - Strip Markdown stuff from text (JavaScript)
README
![default workflow](https://github.com/stiang/remove-markdown/actions/workflows/default.yaml/badge.svg)
## *** 2022-10-18: Important message about the future of this package ***
Hello all, I don’t use this package in my own projects any longer and I have come to the realization that I basically don’t have the bandwidth to maintain the package.However, the package is used quite a bit and I don’t want to just abandon it. So I’m looking for suggestions on how to move forward with someone else in charge of maintaining the package on a day-to-day basis. I’m open to adding collaborators to this repo or moving the entire repo to a more fitting home.
Please contact me directly or post a comment on [the issue I created about this](https://github.com/stiang/remove-markdown/issues/61) (#61).
## What is it?
**remove-markdown** is a node.js module that will remove (strip) Markdown formatting from text.
*Markdown formatting* means pretty much anything that doesn’t look like regular text, like square brackets, asterisks etc.## When do I need it?
The typical use case is to display an excerpt from some Markdown text, without any of the actual Markdown syntax - for example in a list of posts.## Installation
```
npm install remove-markdown
```## Usage
```js
const removeMd = require('remove-markdown');
const markdown = '# This is a heading\n\nThis is a paragraph with [a link](http://www.disney.com/) in it.';
const plainText = removeMd(markdown); // plainText is now 'This is a heading\n\nThis is a paragraph with a link in it.'
```You can also supply an options object to the function. Currently, the following options are supported:
```js
const plainText = removeMd(markdown, {
stripListLeaders: true , // strip list leaders (default: true)
listUnicodeChar: '', // char to insert instead of stripped list leaders (default: '')
gfm: true // support GitHub-Flavored Markdown (default: true)
useImgAltText: true // replace images with alt-text, if present (default: true)
});
```Setting `stripListLeaders` to false will retain any list characters (`*, -, +, (digit).`).
## TODO
PRs are very much welcome. Here are some ideas for future enhancements:* Allow the RegEx expressions to be customized per rule
* Make the rules more robust, support more edge cases
* Add more (comprehensive) tests## Credits
The code is based on [Markdown Service Tools - Strip Markdown](http://brettterpstra.com/2013/10/18/a-markdown-service-to-strip-markdown/) by Brett Terpstra.## Author
Stian Grytøyr