Replace-between NPM

replace-between

CLI utility for replacing text between markers with text from a file or stdin.

replace-between --source API.md --target README.md --token API

To put API in your README.md, you can put text generated by jsdoc2md between  and .

$ jsdoc2md index.js | replace-between --target README.md --token API

A sample README.md for above command could be as below:

# My Module

Lovely description.

# Details

Details of my module

# API

<!--- API BEGIN --->


<!--- API END --->

Option	Req	Description
token	✓	Token text to look for between start and end comment. BEGIN and END words are added automatically.
target	✓	Target file to replace text in.
source		Source file to get replacement text from. If not provided STDIN is used instead.
comment		Predefined comment types to be used for replacement markers. (i.e. 'markdown' for `<!---` `--->`. If not provided, it is tried to be get from target file extension.
begin		Beginning of the comment syntax. i.e `<!---` for markdown.
end		End of the comment syntax. i.e `--->` for markdown.