Skip to content

The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.

1.3 KB
Raw Blame
import { remark } from 'remark'
import type { PluggableList } from 'unified'
import type { Compatible } from 'vfile'

import { remarkHeading } from '../mdx-plugins/remark-heading'
import type { TableOfContents } from '../types'

/**
 * Get Table of Contents from markdown/mdx document (using remark)
 *
 * @param content - Markdown content or file
 */
export function getTableOfContents(content: Compatible): TableOfContents

/**
 * Get Table of Contents from markdown/mdx document (using remark)
 *
 * @param content - Markdown content or file
 * @param remarkPlugins - remark plugins to be applied first
 */
export function getTableOfContents(
  content: Compatible,
  remarkPlugins: PluggableList
): Promise<TableOfContents>

export function getTableOfContents(
  content: Compatible,
  remarkPlugins?: PluggableList
): TableOfContents | Promise<TableOfContents> {
  if (remarkPlugins) {
    return remark()
      .use(remarkPlugins as any)
      .use(remarkHeading)
      .process(content)
      .then((result) => {
        if ('toc' in result.data) return result.data.toc as TableOfContents

        return []
      })
  }

  // compatible with previous versions
  const result = remark().use(remarkHeading).processSync(content)

  if ('toc' in result.data) return result.data.toc as TableOfContents

  return []
}

export type { TableOfContents, TOCItemType } from '../types'