Import Markdown To Confluence



Subscribe to an RSS feed that Confluence Cloud has predefined for you. Notion lets you directly import the following file types: Plaintext (.txt) Markdown (.md or.markdown) Microsoft Word (.docx) Microsoft Excel (.xls) CSV (.csv) HTML (.html) You can also import data from a number of other apps (like Confluence, Asana, Evernote, and Trello to name a few).

DateModified
ByCategoryitsm
Tagsservice managementopen sourcewikiknowledge managementcontent management
Estimated Read Time: 13 min read
Ninja Level:

Introduction about wiki software

I liked using Atlassian Confluence as wiki or knowledge management application. However,Atlassian had announced that the standalone server version would be gone in 2021 February.Also, there would be a price increase of all the existing data center version of Atlassian software.

So, let us look at other alternatives. In this article, I would briefly describeseveral open source and low-cost wiki and knowledge management software.We would have a summary for each product at the bottom of the article.

Table: Curated list of open source and low-cost wiki and knowledge management software

NameLicense and pricing modelLanguages and databaseTarget audiences / use casesProsCons and pain pointsWhich companies or organizations are using it
Wiki.jsAGPL v3.0
  • NodeJS
  • Database: MySQL and PostgreSQL, SQLite and MS SQL Server 2012 or later.According to roadmap, it intended to only support PostgreSQL in 3.x/4.x
Wiki and knowledge management softwareA very active project and support MarkDown natively. It support lots of authentication systems like Keycloak, LDAP and other major identity providers like GitHub, Google, Slack and etc.
  • Feature is not the most comprehensive because Wiki.js 2.x started in around 2019
  • Weak table support but it should be improving
11.6k stars in GitHub, a popular choice for many users
MediawikiGPL v2
  • PHP
  • Database: MySQL 5.5.8+, MariaDB, PostgreSQL 9.2+, SQLite 3.8+
Wiki and knowledge management software (Internet scale)Internationalization and localization. Also, it is a well established software, it had been around since 2002No user deletion, only merges. Refer to this web link for detailsWikipedia, Indie Web Camp. Here is a short list
XWikiLGPL 2.1 and commercial offering
  • Java
  • Database: MySQL 5.7, 8.0 / MariaDB 10.4+PostgreSQL 12+Oracle 19.3.0+
Wiki, CMS and knowledge management softwareWell established, it has been around since 2003Java based, it would consume more memory compared with other smaller wiki softwareTestimonials in here
Documize. Here's the Community editionAGPL v3.0 and commercial offering (cloud and self hosting)
  • Go lang
  • Database:
    • PostgreSQL (v9.6+)
    • Microsoft SQL Server (2016+ with FTS)
    • MySQL (v5.7.10+ and v8.0.12+)
    • Percona (v5.7.16-10+)
    • MariaDB (10.3.0+)
Documentation, wiki and knowledge management softwareSingle binary application, less dependencyCommunity edition has less feature than commercial editionTelefonica, MobyMax and others, according to Documize web site
BookStackMIT
  • PHP
  • Database: MySQL >= 5.6
Wiki and knowledge management software (Good for small businesses)Low system requirement
  • Looks like the editor is a global setting, you either choose the WYSIWYG editor or the MarkDown editor
  • Weaker UI support on smartphone devices
It's a quite popular option with 5.7k+ stars in GitHub
Outline Here's the GitHub repoBSL (delayed open source) and have commercial offering
  • Node.js >= 12 and React
  • Database: PostgreSQL >=9.5 and Redis >=4
Wiki and knowledge management software (Great for internal documentation, meeting notes, KB and etc.)Eye pleasing UI, feature rich and support MarkDown
  • Currently the login option is integrated with Google Workspace and Slack. It is lacking other SSO login options
  • Using the BSL license
It's a quite popular option with 10.2k+ stars in GitHub

Wiki.js

Wiki.js has two versions, 1.x and 2.x. There is active development for the 2.x version.It has lots of modules or features, and more features are being added. By default, thesoftware already has analytics support (Google Analytics, Matoma and etc.), authenticationsupport (Keycloak, LDAP/AD, Slack and etc.), comment systems support (built-in, Disqusand etc.), search engine support (like Elasticsearch, Aloglia and use of databases),draw.io graphing support and so much more. When a page is created, you could only chooseeither using WYSIWYG editor or the MarkDown editor. It is not changeable once a pageis created.

Here's the road map for 3.x and beyond. It would be moving from Vue.js (2.x) toQuasar Vue (3.x). It would be able to import data from Wikimedia, DokuWiki and Confluence.This looks very promising.

Mediawiki

Mediawiki has been around since 2002. The most famous site that use Mediawiki is theWikipedia. It is a battle tested wikisoftware and with active development. It is used by many websites in the Internet. It isalso used by many companies and organizations.

Mediawiki does not support MarkDown natively, so you need to rely on add-ons.To further expanding Mediawiki functionality, take a look onBlueSpice.It is a single application that is based on Mediawiki, so that you do not need to installor maintain several add-on to Mediawiki.

XWiki

XWiki has been around since 2003. The 'X' in XWiki means extensibility.It could import serveral Wiki/Markup syntax, like Mediawiki, Confluence, JSPWiki,Creole, TWiki and XWiki's own syntax. Elv elektronik port devices driver download for windows. It do not have native MarkDown support,but there are extensions or add-ons for MarkDown support. When it comes to editing,you would be using the Advanced WYSIWYG editor. XWiki is a solid alternative toConfluence.

Import Markdown To Confluence

BookStack

Writing the wiki in a book-like format, with chapters and pages, BookStack is a easyto use documentation system. For editing, it looks like the editor is a global setting,you either choose the WYSIWYG editor or the MarkDown editor. Other than that, BookStackhas all the basic features of a wiki system and is easy to install.

To try out BookStack quickly, there isa demo in the offical site.

Outline

Firstly, Outline is not strictly an open source application. It uses BSL license and iscalled delayed open source because the actual source code of the (commercial) applicationwould not be released immediately. In the case for Outline, the change license date is threeyears. So, the source code is only guaranteed to be released as open source at a maximum ofthree years. If you don't want or need to self host, you can check out the commercialhosting option of Outline.

In terms of the UI, it has a modern UI and more polished compared withBookStack. It comes with an intuitive edtiorwith MarkDown support. It has API integration with Slack, Figma and other collaboration systems.The project has 10k+ stars in GitHub and is quite popular.

Conclusion

Besides the list of applications that we had come across in this article, there are lots of optionsout there. Like Dokuwiki, MoinMoin, Trac and etc.

Repositories Import and Export

Import Markdown To Confluence

Note: Importing repositories is supported for all users whereas exporting repositories is only available for non-SaaS users.

To access import and export of repositories, in the Administration module, select Artifactory |Import & Export | Repositories.

Export

When exporting, you need to specify the following parameters:

Target Local Repository
You can specify a single repository to export, or All Repositories
Export Path on Server
The export target directory on your server
Exclude Metadata
When set, repository metadata is excluded from the export. (Maven 2 metadata is unaffected by this setting)
Create .m2 Compatible Export
When set, includes Maven 2 repository metadata and checksum files as part of the export
Output Verbose Log

When set, lowers the log level to 'debug' and redirects the output from the standard log to the import-export log.

Monitoring the log

Import

To disable the system import option, set the artifactory.system.import.enabled property in the artifactory.system.propertiesfile to false.

To access import and export of your entire system, in theAdministrationmodule, selectImport & Export | System


You can import repositories from a server-side folder, or by zipping a repository and uploading it to Artifactory.

When importing, you need to specify the following parameters:

Target Local Repository
You can specify a single repository to import, or All Repositories. The repository layout should be different depending on your selection. Please refer to Import Layout.
Server Path for Import
The import source directory on your server
Repository Zip File
Applicable when importing repo from zip file. Drop the repository zip file
Exclude Metadata
When set, repository metadata are excluded from the import
Output Verbose Log

When set, lowers the log level to 'debug' and redirects the output from the standard log to the import-export log.

Monitoring the log

Don't exclude metadata for Docker

To work with a Docker repository, it must have its metadata intact. Therefore, when importing to/exporting from a Docker repository make sure that Exclude Metadata is not checked.

Importing into a Remote Repository Cache

You can take advantage of remote repositories you have already downloaded to your local environment, and import them directly into a local repository.

For example, you can take your local Maven repository (usually located under ~/.m2) and upload it into Artifactory so that all the artifacts you have already downloaded are now available on the server.


Import Layout

An imported repository needs to be formatted using a Maven 2 repository layout.

When importing a single repository, the file structure within the import folder (or zip file) should be as follows:

Markdown

When importing all repositories, the file structure within the import folder should be as follows:

When importing all repositories, you need to ensure that the names of the directories representing the repositories in the archive match the names of the target repositories in Artifactory.


System Import and Export

Artifactory maintains all security entities (users, groups, permissions and access tokens) when doing a system import.

Note: The System Import and Export feature is not available for Artifactory Cloud users.

Confluence Markdown Code

To access import and export of your entire system, in the Administration module, select Artifactory | Import & Export | System.

Export Path on Server
The target directory for the exported files. You may browse your file system to select the directory
Exclude Content

Export: When set, repository binaries are excluded from the export.

Import: When set, binaries and metadata are excluded from the import. Only builds and configuration files are imported.

Exclude Metadata

When set, repository metadata are excluded from the import/export.
(Maven 2 metadata is unaffected by this setting)

Docker repositories must have metadata

For Docker repositories to work they must have their metadata intact. Therefore, if you have Docker repositories, make sure that Exclude Metadata is not checked when doing a system export or import.

Create .m2 Compatible Export
When set, includes Maven 2 repository metadata and checksum files as part of the export
Create a Zip Archive (Slow and CPU Intensive!)
When set, creates and exports to a Zip archive
Output Verbose Log

When set, lowers the log level to 'debug' and redirects the output from the standard log to the import-export log.

Monitoring the log

The source/target of the import/export operations are folders (Zip archives are not recommended) on the Artifactory server itself.

You can use the built-in server-side browsing inside Artifactory to select server-side source/target folders:

Importing or exporting a large amount of data may be time consuming. During the import/export operation you can browse away from the page and sample the System Logsto monitor progress.

System Import and Export for an HA Cluster

When performing a system export and subsequent import for an HA cluster, you need to follow the procedure below to ensure that the cluster is able to correctly synchronize its nodes.

Setting a Target Artifactory

Confluence Wiki Markdown

  1. Perform a normal system export from the source cluster as described above.
  2. In the target cluster, keep only one node running, and perform a graceful shutdown to all the rest of the nodes
  3. Perform normal system import to the target cluster (which now has only one node running) as described above.
  4. Perform a graceful shutdown of the running node and then restart it
  5. For each additional node:
    1. Delete the following folders

      • $JFROG_HOME/artifactory/var/etc/access

      • $JFROG_HOME/artifactory/var/etc/security

      • $JFROG_HOME/artifactory/var/etc/ui

      • $JFROG_HOME/artifactory/var/etc/plugins

    2. Copy the $JFROG_HOME/artifactory/var/etc/security/master.key from the running node to the additional nodes.

      Master Key

      Copying the $JFROG_HOME/artifactory/var/etc/security/master.key is a critical step in the import process.

    3. Start up the additional nodes.

Import Markdown To Confluence Pdf

Once you have completed the import, we recommend verifying that your HA cluster is up and running normally as described in Testing your HA Configuration.

Convert Confluence To Markdown