feat(markdown-converter): implement markdown converter utility

Author: emerson-pereira

packages/utilities/src/utilities/index.js

@@ -11,4 +11,5 @@ export * from './featureflag';
 export * from './geolocation';
 export * from './ipcinfoCookie';
 export * from './serialize';
+export * from './markdownconverter';
 export * from './settings';

packages/utilities/src/utilities/markdownconverter/index.js

@@ -0,0 +1,8 @@
+/**
+ * Copyright IBM Corp. 2016, 2018
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+export { default as markdownConverter } from './markdownconverter';

packages/utilities/src/utilities/markdownconverter/markdownconverter.js

@@ -0,0 +1,44 @@
+const _htmlTagRegex = /<.*?>/g;
+const _italicRegex = /[_*](.*?)[_*]/g;
+const _boldRegex = /[_*]{2}(.*?)[_*]{2}/g;
+
+/**
+ *
+ * @param {string} str String to be checked for html tags
+ * @returns {string} String with html tags stripped out
+ */
+const _removeHtmlTags = str => str.replace(_htmlTagRegex, '');
+
+/**
+ * Utiltity function for converting markdown into html
+ *
+ * @param {string} str String to convert to html
+ * @param {object} options Object with options for the conversion
+ * @param {boolean} options.italic Defines if should convert italic
+ * @param {boolean} options.bold Defines if should convert bold
+ * @returns {string} String converted to html
+ * @example
+ * import { markdownConverter } from '@carbon/ibmdotcom-utilities';
+ *
+ * markdownConverter('Lorem _ipsum_ __dolor__ *sit* **amet**.')
+ */
+function markdownConverter(str, { italic, bold } = {}) {
+  const isAllStyles = !italic && !bold;
+  let converted = _removeHtmlTags(str);
+
+  if (italic || isAllStyles) {
+    converted = converted.replace(_italicRegex, (match, p1) => {
+      if (!p1.length) {
+        return match;
+      }
+      return `<em>${p1}</em>`;
+    });
+  }
+  if (bold || isAllStyles) {
+    converted = converted.replace(_boldRegex, '<strong>$1</strong>');
+  }
+
+  return converted;
+}
+
+export default markdownConverter;