html-utils

ai-research-agent / extractor/html-to-content/html-utils

HTML Utilities

convertHTMLToEscapedHTML()

function convertHTMLToEscapedHTML(str, unescape): string

Converts HTML special characters like &"'`’ to & escaped codes or vice versa. It handles named entities and hexadecimal numeric character references.

Parameters

Parameter	Type	Default value	Description
str	string	undefined	The string to process.
unescape	boolean	true	default=true - If true, converts & codes to characters. If false, converts characters to codes.

Returns

string

The processed string.

Example

var normalHTML = convertHTMLToEscapedHTML('<p>This & that © 2023 '+
'"Quotes"'Apostrophes' €100 ☺</p>', true)
console.log(normalHTML) // Returns: "<p>This & that © 2023 "Quotes" 'Apostrophes' €100 ☺</p>"

---

convertMarkdownToHTML()

function convertMarkdownToHTML(content, toHtml): string

Converts Markdown text to HTML. It handles the following Markdown elements:

• Headers (h1 to h6)
• Bold text
• Italic text
• Unordered lists
• Ordered lists
• Paragraphs
• Images
• Links
• Code blocks

Parameters

Parameter	Type	Default value	Description
content	string	undefined	The Markdown or HTML content to be converted.
toHtml	boolean	true	default=true - If true, converts Markdown to HTML. If false, converts HTML to Markdown.

Returns

string

The resulting HTML string.

Example

const markdown = "# Header\n\nThis is **bold** and *italic* text.\n\n* List item 1\n* List item 2";
const html = convertMarkdownToHTML(markdown);
console.log(html);
// Output:
// <h1>Header</h1>
// <p>This is <strong>bold</strong> and <em>italic</em> text.</p>
// <ul><li>List item 1</li><li>List item 2</li></ul>

---

convertMathLaTexToImage()

function convertMathLaTexToImage(html): string

Convert LaTex <math> equations found inside HTML into easy-to-read SVG and HTML with KaTex.js.

Parameters

Parameter	Type	Description
html	string	html with math Latex

Returns

string

html with SVG of equations

---

convertURLToAbsoluteURL()

function convertURLToAbsoluteURL(base, relative): string

Convert relative URL to absolute URL using base URL.

Parameters

Parameter	Type	Description
base	string	base url of the domain
relative	string	partial urls like ../images/image.jpg #hash

Returns

string

absolute URL

Example

var absoluteURL = convertURLToAbsoluteURL('https://example.com', 'images/image.jpg')
console.log(absoluteURL) // Returns: "https://example.com/images/image.jpg"
var absoluteURL = convertURLToAbsoluteURL('https://example.com', '//images/image.jpg')
console.log(absoluteURL) // Returns: "https:images/image.jpg"

Author

ai-research-agent (2024)

---

copyHTMLToClipboard()

function copyHTMLToClipboard(html, options): Promise<void>

Copy HTML to clipboard. When pasting into rich text field, pastes rich text. When pasting into plain text field, pastes: plain text, html, or markdown.

Parameters

Parameter	Type	Description
html	string	The HTML content to be copied.
options	{ pastePlainFormat: number; }	The options object.
options.pastePlainFormat	number	default=0 0 - plain text 1 - markdown 2 - html

Returns

Promise<void>

• A promise that resolves when the HTML is copied to the clipboard.

Author

ai-research-agent (2024)

Other

convertHTMLToMarkdown()

function convertHTMLToMarkdown(html): any

Parameters

Parameter	Type
html	any

Returns

any