{"id":16382336,"url":"https://github.com/cryptorodeo/vimwikitoorg","last_synced_at":"2026-04-13T12:31:03.675Z","repository":{"id":64443690,"uuid":"573203106","full_name":"CryptoRodeo/VimWikiToOrg","owner":"CryptoRodeo","description":"Convert VimWiki files to Emacs Org-Mode 🦄","archived":false,"fork":false,"pushed_at":"2022-12-08T14:22:27.000Z","size":74,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-04T04:31:04.741Z","etag":null,"topics":["emacs","org-mode","org-mode-notes","python","vim","vimwiki"],"latest_commit_sha":null,"homepage":"","language":"Python","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/CryptoRodeo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-12-01T23:19:37.000Z","updated_at":"2023-01-06T22:27:12.000Z","dependencies_parsed_at":"2023-01-13T14:46:44.426Z","dependency_job_id":null,"html_url":"https://github.com/CryptoRodeo/VimWikiToOrg","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryptoRodeo%2FVimWikiToOrg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryptoRodeo%2FVimWikiToOrg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryptoRodeo%2FVimWikiToOrg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryptoRodeo%2FVimWikiToOrg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CryptoRodeo","download_url":"https://codeload.github.com/CryptoRodeo/VimWikiToOrg/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240073443,"owners_count":19743761,"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","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","org-mode","org-mode-notes","python","vim","vimwiki"],"created_at":"2024-10-11T04:05:00.083Z","updated_at":"2026-04-13T12:31:03.637Z","avatar_url":"https://github.com/CryptoRodeo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VimWiki To Org Mode 🦄\n\u003e Migration to Org mode, made a bit easier\n\n![workflow](https://github.com/CryptoRodeo/VimWikiToOrg/actions/workflows/main.yml/badge.svg)\n\n## Install or update \n\n```\npip install -U vimwiki-to-org\n```\n\n## What it does:\n\n**Converts this:**\n\n```\n= Header1 =\n== Header2 ==\n=== Header3 ===\n==== Heading4 ====\n===== Heading5 =====\n====== Heading6 ======\n\n*bold text*\n_italic text_\n\n[[wiki_link]]\n[[some wiki|description for some wiki file]]\n\n* bullet list item 1\n* bullet list item 2\n    1) numbered list item 1\n    2) numbered list item 2\n\n{{{python\ndef greet(s):\n    print(\"Hello, \" + s)\n}}}\n\n`echo \"42\"`\n\n| a table |  |\n|---------|--|\n|         |  |\n\n{{file:./some-image.png}}\n\n```\n\n**To this:**\n\n\n```\n* Header1 \n** Header2 \n*** Header3 \n**** Heading4 \n***** Heading5 \n****** Heading6 \n\n*bold text*\n/italic text/\n\n[[file:wiki_link.org]]\n[[some wiki.org][description for some wiki file]]\n\n- bullet list item 1\n- bullet list item 2\n    1) numbered list item 1\n    2) numbered list item 2\n\n#+begin_src python\ndef greet(s):\n    print(\"Hello, \" + s)\n\n#+end_src\n\n~echo \"42\"~\n\n| a table |  |\n|---------|--|\n|         |  |\n\n[[file:./some-image.png]]\n\n```\n\n## Usage:\n\nLaunch via CLI\n```\nvimwiki_to_org -d ~/vimwiki -o ./some_dir/\n```\n\nor\n\n```\npython -m vimwiki_to_org -d ~/vimwiki -o ./some_dir/\n```\n\n## Help\n```\nvimwiki_to_org -h\n\nusage: vimwiki_to_org [-h] [-d WIKI_PATH] [-o OUTPUT_PATH]\n\noptions:\n  -h, --help            show this help message and exit\n  -d WIKI_PATH, --wiki-path WIKI_PATH\n                        path to vimwiki directory (optional) (default: /home/USERNAME/vimwiki/)\n  -o OUTPUT_PATH, --output-path OUTPUT_PATH\n                        path to output directory (optional) (default: PROJECT_DIR/converted_files/)\n```\n\n## Goals:\n - Make it easier to migrate over existing VimWiki files to `.org` files\n - Have a *reasonable* amount `.wiki` file content converted to it's `.org` equivalent (**at least** 60-70%) so there's less to manually edit.\n \n## Features:\n\n**Extend for your own situation:**\n - The current config should be *good enough* for most basic VimWiki markdown, but **everyone's notes are different**.\n - Configure the [regex](./vimwiki_to_org/src/converters/helpers/wiki_regex.py) and the [markdown replacements](./vimwiki_to_org/src/converters/helpers/org_markdown.py) for your specific situation.\n\n**Your ~/vimwiki/ directory is safe:**\n- Your `.wiki` files are **not modified**, just read.\n- Regular files are not touched (`.png`, etc). **Those will have to be manually transferred**.\n\n**Keep your linked pages:**\n- Links between `.wiki` files are converted to link to their new `.org` pages.\n\n```\n[[SomeWikiPage]] -\u003e [[file:SomeWikiPage.org]]\n```\n\n**Regex is applied by priority:**\n- Headers, code blocks and links get handled first before converting text emphasis markdown\n- This is to avoid accidentally converting things like:\n  - underscores used in a code block to italic text: `some_var_name -\u003e some/var/name`\n  - file names with underscores converted to italic text: ```file:some_file_name.png -\u003e file:some/file/name.png```\n  - etc, etc.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcryptorodeo%2Fvimwikitoorg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcryptorodeo%2Fvimwikitoorg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcryptorodeo%2Fvimwikitoorg/lists"}