function rewriteLinksInMdContent(mdContent, filePath, cfg = rewriteLinksConfig) {
  const rewrite =
    (/** @type {string} */ repoBasePath, /** @type {string} */ repoRootPath) =>
    (/** @type {string} */ href) => {
      const isRelativeUrlPattern = /^(\.\/|\.\.\/)/; // starts with './' or '../'
      if (!href.match(isRelativeUrlPattern)) {
        return href;
      }

      const fileFolder = filePath.replace(/(.*\/).*/g, '$1');
      const absoluteLocalPath = path.resolve(fileFolder, href);
      // relativeFromRootPath: for instance 'packages/my-component/docs/' when
      // filePath is 'path/to/repo/packages/my-component/docs/myDoc.md'
      const relativeFromRootPath = absoluteLocalPath.replace(repoRootPath, '').slice(1);
      // newRoot: https://github.com/ing-bank/lion/blob/master/packages/my-component/docs/

      return repoBasePath + relativeFromRootPath;
    };

  const mdLink = (
    /** @type {string} */ href,
    /** @type {string} */ title,
    /** @type {string} */ text,
  ) =>
    `[${text}](${rewrite(cfg.repoBasePath, cfg.monorepoRootPath)(href)}${title ? ` ${title}` : ''})`;

  // /^!?\[(label)\]\(href(?:\s+(title))?\s*\)/
  const linkPattern = '!?\\[(.*)\\]\\(([^|\\s]*)( +(.*))?\\s*\\)'; // eslint-disable-line
  const linkReplaced = mdContent.replace(new RegExp(linkPattern, 'g'), (_, p1, p2, p3) =>
    mdLink(p2, p3, p1),
  );

  const imgSrcPattern = `src *= *['"](.*)['"]`;
  const imageReplaced = linkReplaced.replace(
    new RegExp(imgSrcPattern, 'g'),
    (_, p1) => `src="${rewrite(cfg.assetBasePath, cfg.monorepoRootPath)(p1)}`,
  );

  return imageReplaced;
}
Rewrites all relative links of markdown content to absolute links.
Also includes images. See: https://github.com/tcort/markdown-link-extractor/blob/master/index.js
@param {string} mdContent - contents of .md file to parse
@param {string} filePath - local filesystem path of md file,
like '/path/to/lion/packages/my-component/docs/myClass.md'
@param {object} cfg - configurantion object
@param {string} cfg.repoBasePath - root repository url for the absolute result links
@param {string} cfg.assetBasePath - root asset url for the absolute result image url
@param {string} cfg.monorepoRootPath - local filesystem root path of the monorepo
@returns {string} adjusted contents of input md file (mdContent)