Skip to content

Markdown Export

github-actions[bot] edited this page Apr 12, 2024 · 50 revisions

core.export.markdown

Neorg's Markdown Exporter

Overview

This module exists as an interface for core.export to export .norg files to Markdown. As a user the only reason you would ever have to touch this module is to configure how you'd like your markdown to be exported (i.e. do you want to support certain extensions during the export). To learn more about configuration, consult the relevant section.

Configuration

  • extension
    (string)

    Used by the exporter to know what extension to use when creating markdown files. The default is recommended, although you can change it.

    "md"
  • extensions
    (empty list)

    Any extensions you may want to use when exporting to markdown. By default no extensions are loaded (the exporter is commonmark compliant). You can also set this value to "all" to enable all extensions. The full extension list is: todo-items-basic, todo-items-pending, todo-items-extended, definition-lists, mathematics, metadata and latex.

  • mathematics
    (table)

    Data about how to render mathematics. The default is recommended as it is the most common, although certain flavours of markdown use different syntax.

    • block
      (table)

      Block-level mathematics are represented as such:

      $$
      \frac{3, 2}
      $$
      • end
        (string)

        "$$"
      • start
        (string)

        "$$"
    • inline
      (table)

      Inline mathematics are represented $like this$.

      • end
        (string)

        "$"
      • start
        (string)

        "$"
  • metadata
    (table)

    Data about how to render metadata There are a few ways to render metadata blocks, but this is the most common.

    • end
      (string)

      "---"
    • start
      (string)

      "---"

Required Modules

Clone this wiki locally