From mboxrd@z Thu Jan 1 00:00:00 1970 From: Divan Santana Subject: org 2 gfm markdown and back again Date: Tue, 06 Nov 2018 11:14:50 +0200 Message-ID: <87y3a6lg8l.fsf@santanas.co.za> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:48292) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gJxhB-0005Lc-OU for emacs-orgmode@gnu.org; Tue, 06 Nov 2018 04:30:50 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gJxh6-0005OG-Py for emacs-orgmode@gnu.org; Tue, 06 Nov 2018 04:30:49 -0500 Received: from outmail148106.authsmtp.co.uk ([62.13.148.106]:24663) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gJxh1-0005Gx-GJ for emacs-orgmode@gnu.org; Tue, 06 Nov 2018 04:30:39 -0500 Received: from punt18.authsmtp.com (punt18.authsmtp.com [62.13.128.225]) by punt21.authsmtp.com. (8.15.2/8.15.2) with ESMTP id wA69EuXM076975 for ; Tue, 6 Nov 2018 09:14:56 GMT (envelope-from divan@santanas.co.za) List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: emacs-orgmode@gnu.org Cc: Pierre Neidhardt Hi fellow people :) So like a lot of you, I'd love to write all my documentation in orgmode. However I work with gitlab flavoured markdown a lot in our environment. Wishfully one can convert easily between orgmode and markdown and back again. Therefore I need to be able to convert easily back and forth between the two formats. There are some issues with this and wondering what your experiences are with this (for those that are interested)? I wrote about this situation briefly in my blog on plain text documentation. [1] https://divansantana.com/plain-text-documentation/index.html pandoc orgmode support is not good enough at converting orgmode to markdown and back again. For example converting this org file[2] to markdown with pandoc does not result in this properly formatted gfm markdown file[3]. [2] https://gitlab.com/ambrevar/ambrevar.gitlab.io/blob/master/source/guix-packaging/index.org [3] https://git.savannah.gnu.org/cgit/guix/guix-artwork.git/tree/website/posts/packaging-tutorial.md Using the various ~org-md-~ functions from ~ox-md.el~ is better. However it only supports org2markdown, not the reverse. Furthermore, it still doesn't do a perfect job with the conversation. Pierre Neidhardt wrote a nice wrapper which improves the org2markdown export[4]. [4] https://gitlab.com/ambrevar/ambrevar.gitlab.io/blob/master/source/guix-packaging/org2md.el The result works very well in my testing. However this still doesn't solve the markdown2org situation. Anyone thought of something box to improve this situation? -- Divan Santana https://divansantana.com