Merge pull request #3432 from netlimpopo/patch-2

Update importing-notes.md

Author: pbek

webpage/src/getting-started/importing-notes.md

@@ -10,6 +10,32 @@ Images, attachments, tags, basic formatting and metadata will be imported as wel
 
 There is a Joplin import dialog you can reach in the `Note / Import` menu.
 
+## Obsidian
+
+1. Install the community plugin ["Better Markdown Links"](https://github.com/mnaoumov/obsidian-better-markdown-links) to convert all *wikilink and Obsidian flavoured markdown links (OFM)* and make Obsidian operate with *standard markdown links*. 
+
+2. Open the same files (same vault) in QOwnNotes. Install the QOwnNotes script [link-importer-and-converter-for-obsidian-github-pandoc-markor-and-others](https://github.com/qownnotes/scripts/tree/main/link-importer-and-converter-for-obsidian-github-pandoc-markor-and-others) and press the import button "ObsidianImport" in the script panel to convert all files.
+
+Exporting from QOwnNotes to Obsidian is not needed.  
+
+::: warning Warning
+*Caution(!)*: The plugin `"Better Markdown Links"` silently adapts links when Obsidian is opened or when folders, files or headings are renamed. Press the "ObsidianImport" button in QOwnNotes everytime you have changed files in Obsidian, otherwise some links might not be recognised by QOwnNotes anymore!
+:::
+
+## VS Codium / Github /  Markor / Typora / Pandoc and others (Github flavoured markdown GFM) 
+
+Githubflavoured markdown (GFM) uses hyphenstyle link headings (spaces converted to hyphens). A reference to a heading such as `## Heading with spaCes` for example will look like `[notelink](β_note.md#heading-with-spaces)`.
+
+QOwnNotes and Obsidian (Obsidian flavoured markdown OFM) use *urlencoded (percentencoded) heading fragments* (spaces converted to %20 and keeping capital letters), so the same link will look different `[notelink](%CE%B2_note.md#Heading%20with%20spaCes)`. 
+
+To convert between GFM and QOwnNotes/Obsidian (OFM), just open the files in QOwnNotes. Install the QOwnNotes script [link-importer-and-converter-for-obsidian-github-pandoc-markor-and-others](https://github.com/qownnotes/scripts/tree/main/link-importer-and-converter-for-obsidian-github-pandoc-markor-and-others) and press the import button "GFMImport" in the script panel to convert all files
+
+Exporting from QOwnNotes to GFM works for a single page (useful for a consecutive conversion with pandoc) or for all files. 
+
+::: warning Warning
+*Caution*: Possible loss of information in heading links in special cases! Assume you have a note `β_note.md` with several identical headings like `## Advantages` within the *same (!) note* . GFM allows to reference each heading with `[notelink](%CE%B2_note.md#advantages), [notelink](%CE%B2_note.md#advantages-1), [notelink](%CE%B2_note.md#advantages-2), ... `. *Neither QOwnNotes nor Obsidian allow for this!* QOwnnotes and Obsidian both need unique heading names within the same document to be able to reference each of them! As this feature is not supported at all, after the conversion those links will all point to the first occuring heading with that particular name `[notelink](%CE%B2_note.md#advantages)` (this is especially relevant in long documents)! As a workaround just add text to the headings and update the links to the headings first (make them unique).
+:::
+
 ## Various Formats
 
 The command line tool [jimmy](https://github.com/marph91/jimmy) can convert various formats to Markdown