Convert a folder of org files to markdown§

I wanted to see how my [[org-roam]] files look like in [[Obsidian]]‘s graph view. Commence massive yak shave to recursively convert a folder of org files to markdown. Result below, pretty much a copy paste from here: Bulk Org-Mode to Github Flavored Markdown. (I didn’t bother with github flavoured markdown though).

In the process I discovered that pandoc doesn’t convert extensions of cross-file links, which was massively annoying.

;;;###autoload
(require 'org)

(defun dired-org-to-markdown ()
    (let ((files
                     (append
                                 (let ((default-directory "."))
                                               (mapcar #'expand-file-name
                                                                           (file-expand-wildcards "**/*.org")))
                                           (let ((default-directory "."))
                                                         (mapcar #'expand-file-name
                                                                                     (file-expand-wildcards "*.org")))
                                                    )
                              ))
          (mapc
                 (lambda (f)
                          (with-current-buffer
                                       (find-file-noselect f)
                                                (org-md-export-to-markdown)))
                      files))
      )

(dired-org-to-markdown)

Pop the above in a file called something like export.el, then run it with:

emacs --batch --load=export.el

Ninja§

Jethro Kuan uses Ninja for this: https://github.com/jethrokuan/braindump/blob/master/build.py

Converting links to wikilink syntax§

I’d like to do this so I could export to a repo that could be picked up by [[Agora]].

I haven’t done it, but it would probably be done by using a filter on the Markdown org-export backend:

(defun commonplace/md-link-to-wikilink (text backend info)
  (when (org-export-derived-backend-p backend 'md)
    (replace-regexp-in-string "..." "..." text)))

(add-to-list 'org-export-filter-link-functions
             'commonplace/md-link-to-wikilink)

• #go https://workspace.google.com/u/0/marketplace/app/docs_to_markdown/700168918607

• [[flancian]] https://twitter.com/flancian/status/1507752249325506560 pull

This plugin enhances Markdown processing to support GitHub Flavored Markdown (GFM) which adds features like autolink literals, footnotes, strikethrough, tables and tasklists.

In addition, this plugin adds optional features for typographic refinement (such as converting straight quotes to curly quotes, dashes to en-dashes/em-dashes, and ellipses) and automatic heading links as a symbol that appears next to the heading on hover.

[!note] For information on how to add, remove or configure plugins, see the [[Configuration]] page.

This plugin accepts the following configuration options:

• enableSmartyPants: When true, enables typographic enhancements. Default is true.
• linkHeadings: When true, automatically adds links to headings. Default is true.

API§

• Category: Transformer
• Function name: Plugin.GitHubFlavoredMarkdown().
• Source: quartz/plugins/transformers/gfm.ts.

• [[2023-03-11 18:23:46]] [[@vera:fairydust.space]] (link):
  • speaking of org mode the agora is currently dying trying to parse org, it’s probably my new logseq files that I converted to org because [[I don’t like markdown]]

myst markdown§

Core idea§

Links§

This plugin provides support for [[Obsidian compatibility]].

[!note] For information on how to add, remove or configure plugins, see the [[Configuration]] page.

This plugin accepts the following configuration options:

• comments: If true (default), enables parsing of %% style Obsidian comment blocks.
• highlight: If true (default), enables parsing of == style highlights within content.
• wikilinks:If true (default), turns [[wikilinks]] into regular links.
• callouts: If true (default), adds support for [[callout]] blocks for emphasizing content.
• mermaid: If true (default), enables [[Mermaid diagram]] rendering within Markdown files.
• parseTags: If true (default), parses and links tags within the content.
• parseArrows: If true (default), transforms arrow symbols into their HTML character equivalents.
• parseBlockReferences: If true (default), handles block references, linking to specific content blocks.
• enableInHtmlEmbed: If true, allows embedding of content directly within HTML. Defaults to false.
• enableYouTubeEmbed: If true (default), enables the embedding of YouTube videos and playlists using external image Markdown syntax.
• enableVideoEmbed: If true (default), enables the embedding of video files.
• enableCheckbox: If true, adds support for interactive checkboxes in content. Defaults to false.
• disableBrokenWikilinks: If true, replaces links to non-existent notes with a dimmed, disabled link. Defaults to false.

[!warning] Don’t remove this plugin if you’re using [[Obsidian]] to author the content!

API§

• Category: Transformer
• Function name: Plugin.ObsidianFlavoredMarkdown().
• Source: quartz/plugins/transformers/ofm.ts

This plugin provides support for ox-hugo compatibility. See [[OxHugo compatibility]] for more information.

[!note] For information on how to add, remove or configure plugins, see the [[Configuration]] page.

This plugin accepts the following configuration options:

• wikilinks: If true (default), converts Hugo {{ relref }} shortcodes to Quartz [[wikilinks]].
• removePredefinedAnchor: If true (default), strips predefined anchors from headings.
• removeHugoShortcode: If true (default), removes Hugo shortcode syntax ({{}}) from the content.
• replaceFigureWithMdImg: If true (default), replaces <figure/> with ![]().
• replaceOrgLatex: If true (default), converts Org-mode [[Latex]] fragments to Quartz-compatible LaTeX wrapped in $ (for inline) and $$ (for block equations).

[!warning] While you can use this together with [[ObsidianFlavoredMarkdown]], it’s not recommended because it might mutate the file in unexpected ways. Use with caution.

If you use toml frontmatter, make sure to configure the [[Frontmatter]] plugin accordingly. See [[OxHugo compatibility]] for an example.

API§

• Category: Transformer
• Function name: Plugin.OxHugoFlavoredMarkdown().
• Source: quartz/plugins/transformers/oxhugofm.ts.

This plugin provides support for Roam Research compatibility. See [[Roam Research Compatibility]] for more information.

[!note] For information on how to add, remove or configure plugins, see the [[Configuration]] page.

This plugin accepts the following configuration options:

• orComponent: If true (default), converts Roam {{ or:ONE|TWO|THREE }} shortcodes into HTML Dropdown options.
• TODOComponent: If true (default), converts Roam {{[[TODO]]}} shortcodes into HTML check boxes.
• DONEComponent: If true (default), converts Roam {{[[DONE]]}} shortcodes into checked HTML check boxes.
• videoComponent: If true (default), converts Roam {{[[video]]:URL}} shortcodes into embeded HTML video.
• audioComponent: If true (default), converts Roam {{[[audio]]:URL}} shortcodes into embeded HTML audio.
• pdfComponent: If true (default), converts Roam {{[[pdf]]:URL}} shortcodes into embeded HTML PDF viewer.
• blockquoteComponent: If true (default), converts Roam {{[[>]]}} shortcodes into Quartz blockquotes.

API§

• Category: Transformer
• Function name: Plugin.RoamFlavoredMarkdown().
• Source: quartz/plugins/transformers/roam.ts.

• [[flancian]] https://social.coop/@flancian/108368339357306316 pull

• [[flancian]] https://twitter.com/flancian/status/1529806636939984900 pull