{"id":13443321,"url":"https://github.com/tecosaur/org-pandoc-import","last_synced_at":"2025-08-24T06:15:29.660Z","repository":{"id":41498955,"uuid":"287810742","full_name":"tecosaur/org-pandoc-import","owner":"tecosaur","description":"Mirror of https://git.tecosaur.net/tec/org-pandoc-import","archived":false,"fork":false,"pushed_at":"2022-10-13T15:46:19.000Z","size":706,"stargazers_count":251,"open_issues_count":10,"forks_count":14,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-03T02:09:21.118Z","etag":null,"topics":["emacs","emacs-packages","mirror","pandoc"],"latest_commit_sha":null,"homepage":"","language":"Emacs Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tecosaur.png","metadata":{"files":{"readme":"README.org","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"tecosaur","liberapay":"tec"}},"created_at":"2020-08-15T19:20:35.000Z","updated_at":"2025-03-19T23:17:21.000Z","dependencies_parsed_at":"2023-01-20T00:19:48.733Z","dependency_job_id":null,"html_url":"https://github.com/tecosaur/org-pandoc-import","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/tecosaur/org-pandoc-import","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tecosaur%2Forg-pandoc-import","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tecosaur%2Forg-pandoc-import/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tecosaur%2Forg-pandoc-import/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tecosaur%2Forg-pandoc-import/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tecosaur","download_url":"https://codeload.github.com/tecosaur/org-pandoc-import/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tecosaur%2Forg-pandoc-import/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271805164,"owners_count":24824796,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-24T02:00:11.135Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["emacs","emacs-packages","mirror","pandoc"],"created_at":"2024-07-31T03:01:59.153Z","updated_at":"2025-08-24T06:15:29.607Z","avatar_url":"https://github.com/tecosaur.png","language":"Emacs Lisp","funding_links":["https://github.com/sponsors/tecosaur","https://liberapay.com/tec"],"categories":["Emacs Lisp"],"sub_categories":[],"readme":"#+title: Org Pandoc Import\n#+author: tecosaur\n\n#+html: \u003cp\u003e\u003cimg src=\"https://img.shields.io/badge/Emacs-26.3+-blueviolet.svg?style=flat-square\u0026logo=GNU%20Emacs\u0026logoColor=white\"\u003e\n#+html: \u003cimg src=\"https://img.shields.io/badge/stage-stable-green?style=flat-square\"\u003e\n#+html: \u003cimg src=\"https://img.shields.io/badge/-Linux-fcc624?logo=linux\u0026style=flat-square\u0026logoColor=black\"\u003e\n#+html: \u003cimg src=\"https://img.shields.io/badge/-MacOS-lightgrey?logo=apple\u0026style=flat-square\u0026logoColor=black\"\u003e\n#+html: \u003ca href=\"https://liberapay.com/tec\"\u003e\u003cimg src=\"https://shields.io/badge/support%20my%20efforts-f6c915?logo=Liberapay\u0026style=flat-square\u0026logoColor=black\"\u003e\u003c/a\u003e\u003c/p\u003e\n\nThe worst part about =org-mode=? Having to leave it.\n\nThis package aims to reduce this pain by leveraging [[https://pandoc.org/][Pandoc]] to convert selected\nfile types /to/ org.\n\n*There are two tiers of non-org file avoidance:*\n\n 1. The basic \"get me out of here\" ---\n    ~org-pandoc-import-{to,as}-org~ allows you to easily convert supported non-org\n    files to an org file/buffer with Pandoc\n 2. \"I don't even want to /see/ non-org files\" --- ~org-pandoc-import-transient-mode~\n    is for you\n    - (via file handlers) intercepts requests for non-org files it knows it can convert\n    - uses ~org-pandoc-import-to-org~ to convert the file to a temporary org file\n    - opens this org file instead\n    - exports back to the original non-org file on save\n\n[[file:org-pandoc-import.svg]]\n\n* Installation\n** Straight\n#+begin_src elisp\n(use-package org-pandoc-import\n  :straight (:host github\n             :repo \"tecosaur/org-pandoc-import\"\n             :files (\"*.el\" \"filters\" \"preprocessors\")))\n#+end_src\n** Doom\n#+begin_src elisp\n;; $DOOMDIR/packages.el\n(package! org-pandoc-import\n  :recipe (:host github\n           :repo \"tecosaur/org-pandoc-import\"\n           :files (\"*.el\" \"filters\" \"preprocessors\")))\n\n;; $DOOMDIR/config.el\n(use-package! org-pandoc-import :after org)\n#+end_src\n\n** Dependences\n+ Pandoc\n\nThat's the only hard dependency. However ~ox-pandoc~ and ~ox-gfm~ can be useful for\nexporting with ~org-pandoc-import-transient-mode~.\n\nThat said, as they are currently implemented, the pre-processors for /Rmarkdown/\nand /TSV/ files use ~sed~ (only really affects Windows users).\n \n* Screenshots\n\n[[file:screenshots/odt.png]]\n\n[[file:screenshots/markdown.png]]\n\n[[file:screenshots/csv.png]]\n\n* Default backends\n+ markdown :: associated with: =.md=, =.markdown=\n+ LaTeX :: associated with: =.tex=, =.latex=\n+ reStructuredText :: (~rst~) associated with: =.rst=\n+ ODT :: associated with: =.odt=\n+ DOCX :: associated with: =.docx=\n+ Jupyter Notebooks :: (~ipynb~) associated with: =.ipynb=\n+ Rmarkdown :: (~markdown~) associated with: =.Rmd=, =.rmd=\n+ CSV :: associated with: =.csv=\n+ TSV :: (~csv~) associated with: =.tsv=\n\nCurrently /Rmarkdown/ and /TSV/ files require ~sed~ in order to pre-process the file\nfor Pandoc.\n\n** Default transient-mode backends\nPlease note that this mode is off by default.\nIt is however a global mode, so enable it once in your config and it will be\nactive everywhere.\n\nThe active transient backends are determined by\n~org-pandoc-import-transient-associations~.\n\n+ markdown :: using Org's ~gfm~ export if available, otherwise ~md~\n+ ODT :: using Org's ~odt~ export\n+ csv, tsv :: using ~org-table-export~\nWhen ~ox-pandoc~ is available, the following formats are also enabled by default,\nand use ~ox-pandoc~ to export.\n+ =rst=\n+ =docx=\n\n* Adding new backends\nFor something supported out of the box by Pandoc, it couldn't be easier ---\njust\n#+begin_src elisp\n(org-pandoc-import-backend foo)\n#+end_src\n\nThis will add ~foo~ to ~org-pandoc-import-backends~, and create the following\nfunctions\n+ ~org-pandoc-import-foo-as-org~\n+ ~org-pandoc-import-foo-to-org~\nWhich will reference these variables,\n+ ~org-pandoc-import-foo-args~\n+ ~org-pandoc-import-foo-filters~\n+ ~org-pandoc-import-foo-preprocessors~\n+ ~org-pandoc-import-foo-extensions~\nThat last variable will be set to ~(\"foo\")~, and will cause\n~org-pandoc-import-{to,as}-org~ to automatically select this backend when called\non =.foo= files.\n\nThese all have docstrings --- check them out!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftecosaur%2Forg-pandoc-import","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftecosaur%2Forg-pandoc-import","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftecosaur%2Forg-pandoc-import/lists"}