Package: obs2org
Obs2Orgmore badgesObs2Org is a cross platform command (works on *BSD, Linux, OS X and Windows) line program to convertObsidianstyle Markdown files toOrg-Modefiles for Emacs and other Editors that support Org-Mode.It converts the Markdown files usingPandocand afterwards corrects the links to headings in other Org-Mode files, converts the hash-tag style Obsidian tags to Org-Mode style tags and puts angle brackets around dates.ExampleObs2Org converts a Markdown file like to following:---
title: "Programming"
author:-keywords:-Programming
tags:-Programminglang: en---# ProgrammingKeywords:#Programming## Lisp### BooksKeywords:#Lisp,#Book-Lisp Cookbook, 'recipies' to solve common problems using Lisp: [[Books#Lisp Cookbook]]-**Peter Seibel**:*Practical Common Lisp*: [[Books#Practical Common Lisp]]-**Peter Norvig**:*Paradigms of Artificial Intelligence Programming: Case Studies in Common Lisp*: [[Books#Paradigms of Artificial Intelligence Programming]]### State of the Common Lisp ecosystem, 20202021-10-08

Keywords:#Lisp,#Ecosystem,#2020Editors, libraries, compilers, ...
[State of the Common Lisp ecosystem, 2020](https://lisp-journey.gitlab.io/blog/state-of-the-common-lisp-ecosystem-2020/#development)to the following Org-Mode file:#+title: Programming

* Programming              :Programming:
:PROPERTIES:
:CUSTOM_ID: programming
:END:

* Lisp
:PROPERTIES:
:CUSTOM_ID: lisp
:END:

*** Books   :Lisp:Book:
:PROPERTIES:
:CUSTOM_ID: bücher-1
:END:


- Lisp Cookbook, 'recipies' to solve common problems using Lisp: [[file:Books.org::#lisp-cookbook][Lisp Cookbook]]
- *Peter Seibel*: /Practical Common Lisp/: [[file:Books.org::#practical-common-lisp][Practical Common Lisp]]
- *Peter Norvig*: /Paradigms of Artificial Intelligence Programming: Case Studies in Common Lisp/: [[file:Books.org::#paradigms-of-artificial-intelligence-programming][Paradigms of Artificial Intelligence Programming]]

*** State of the Common Lisp ecosystem, 2020   :Lisp:Ecosystem:2020:
:PROPERTIES:
:CUSTOM_ID: state-of-the-common-lisp-ecosystem-2020
:END:
<2021-10-08>
Editors, libraries, compilers, ... [[https://lisp-journey.gitlab.io/blog/state-of-the-common-lisp-ecosystem-2020/#development][State of the Common Lisp ecosystem, 2020]]SeeInstallationandUsagefor information on how to do that.The PyPI (pip) package can be found atObs2Org at PyPIAdditional Documentation can be found atRead the DocsTable of ContentsExampleTable of ContentsInstallationPandocObs2OrgPython, at Least Version 3.9The PyPI Obs2Org PackageUsageExamplesSupported LinksDevelopmentPython, version > 3.9SetupScriptsDocumentationSourcesLicenseBadgesExternal ChecksStatic Code ChecksTestsInstallationPandocPandocis needed to do the actual conversion of Markdown files to Org-Mode files.SeeInstalling pandocon how to install Pandoc for your OS.Obs2OrgPython, at Least Version 3.9The PyPI Obs2Org PackageInstall the PyPI (pip) packageobs2orgfor all users on your computer as administrator/root:Linux, OS X:sudopipinstallobs2orgWindows:Open an administrator shell by writingcmdin the search field of the taskbar, ricght click on the command app and select "Run as Adminsitrator".
in this shell execute:pipinstallobs2orgUsageUse Obs2Org by running it as a normal user (notadministrator or root) as Python module usingLinux, OSX:python3-mobs2org--versionWindowspython-mobs2org--versionThis should yield the version string like>python-mobs2org--versionobs2org1.2.0To get a text explaining the usage of Obs2Org, use the argument--helpor the short form-h:Windows:python-mobs2org--helpLinux, OS X:python3-mobs2org--helpOutput:>python-mobs2org--helpusage:python-mobs2org[-h][-V][-pPANDOC][-n][-u][-oOUT_PATH][MARKDOWN_FILES ...]ConvertsmarkdownformattedfilestoOrg-ModeformattedfilesusingPandoc.positionalarguments:MARKDOWN_FILESThepathtothemarkdownfilesordirectorytoconvertto...ExamplesThese examples only work if Pandoc is in the PATH of your shell. If it isn't you can add the path to Pandoc by using the argument--pandocor-p.To set the path to Pandoc toc:/pandoc/pandocadd--pandoc c:/pandoc/pandocor-p c:/pandoc/pandocto each invocation of Obs2Org.Example:python-mobs2org./Markdown-o../Org/--pandocc:/pandoc/pandoccurrent directorypython-mobs2orgWhich is the same aspython-mobs2org./Converts all markdown files with a suffix of.mdin the current working
directory and all its subdirectories to files in Org-Mode format with the
same base filename but a.orgsuffix.one filepython-mobs2orghugo.md-osepp.orgConverts the markdown documenthugo.mdto an Org-Mode document namedsepp.org.all files with extension.mdpython-mobs2org*.mdConverts all markdown files with a suffix of.mdin the current working
directory to files in Org-Mode format with the same base filename but a.orgsuffix.convert files to given directorypython-mobs2org*.md-o../Org/Converts all markdown files with a suffix of.mdin the current working
directory to files in Org-Mode format with the same base filename but a.orgsuffix in the directory../Org. The directory to save tomusthave a slash/at the end.convert files in given directory to other directorypython-mobs2org./Markdown-o../Org/Converts all markdown files with a suffix of.mdin the directory./Markdownand its subdirectories to files in Org-Mode format with
the same base filename but a.orgsuffix in the directory../Org.
The directory to save tomusthave a slash/at the end.Add UUID file headers to any file that doesn't already have one - flag-uor--uuid:python-mobs2org./Markdown-o../Org/-uConverts all markdown files with a suffix of.mdin the directory./Markdownand its subdirectories to files in Org-Mode format with
the same base filename but a.orgsuffix in the directory../Org. Add file headers with an UUID if not already present.
The directory to save tomusthave a slash/at the end.Treat Pandoc-style citation links as normal links - flag-nor--no-cite:python-mobs2org./Markdown-o../Org/-nConverts all markdown files with a suffix of.mdin the directory./Markdownand its subdirectories to files in Org-Mode format with
the same base filename but a.orgsuffix in the directory../Org. Treat links like[[@Name]]as normal link to a file@Name.orginstead of Pandoc-style citation[[cite:@Link]].
The directory to save tomusthave a slash/at the end.Supported LinksThe following list shows which Markdown links are converted to which Org-Mode links:[[books#My Heading]]is changed to[[file:books.org::#my-heading][My Heading]].[[Note]]is changed to[[file:Note.org::#note][Note]].[[#heading-id|Caption]]is changed to[[#heading-id][Caption]][[file|Caption]]is changed to[[file][Caption]][[#Heading]]is changed to[[*Heading]]if-nor--no-citeis set, a Pandoc citation is treated as a normal link:[[@Link]]is changed to[[file:@Link.org][Link]]as default Pandoc citation links are converted to citation links:[[@Link]]is changed to[[cite:@Link]]DevelopmentPython, version > 3.9You need Python 3.9 or newer.SetupRunpipenv install --devto install the Python environment in the project directoryRunpipenv run pre-commit installto install the pre commit hooks to git. Now every time you commit a change, the linters are run.To run the pre commit checks manually:pipenv run pre-commit run --all-filesScripts./make_package.sh- Linux, OS X: build the Obs2Org PyPI package./make_package.bat- Windows: build the Obs2Org PyPI package. This is disabled on Windows, because the scripts would not be executable because of the Windows filesystem../run_local_linters.sh- Linux, OS X: run all configured linters on the Source code and tests../run_local_linters.bat- Windows: run all configured linters on the Source code and tests../run_tests.sh- Linux, OS X: run all tests../run_tests.bat- Windows: run all tests.DocumentationThs source files for theRead the Docssite are located in the directory./obs2org/doc/sourceSourcesThe sources of the program are in the directory./obs2org/, the test sources and fixtures in./tests/LicenseObs2Org ist licensed under the GPLv3.0, see fileLICENCE.BadgesExternal ChecksStatic Code ChecksTests