Wiki linkek és Markdown linkek
[[wiki-stílusú]] linkek Markdown linkekre konvertálása, vagy fordítva.
Wiki linkek és Markdown linkek
Az olyan jegyzetelő alkalmazások, mint az Obsidian, a TiddlyWiki és a régebbi wikik double bracket segítségével linkelnek oldalakat: [[Oldal neve]] vagy [[Oldal neve|megjelenítendő szöveg]]. A statikus oldalgenerátorok és a legtöbb Markdown renderer az szabványos [megjelenítendő szöveg](útvonal) formátumot várja. Ez az eszköz az egész dokumentumot átalakítja a két szintaxis között mindkét irányban, így a wiki export Markdown blogra való migrálása — vagy fordítva — nem jelenti azt, hogy minden linket manuálisan kell újraírni.
Az irány beállítás meghatározza, hogy melyik szintaxis kerül beolvasásra és melyik kerül kiírásra; a swap vezérlővel ellenőrizheti az átalakítást és a fordított utat. A célfájl kiterjesztés azt szabályozza, hogy mi kerül az előállított útvonalhoz — .md statikus oldalhoz, .html renderelt kimenethez, vagy semmi, ha a linkek már kiterjesztés nélküliek. A szóközök beállítása azt határozza meg, hogy a "Projekt terv" hogyan alakul át — "Projekt-terv.md", "Projekt_terv.md" vagy megtartja a szóközt. A diakritikus jelek URL-kódolása az akcentusos oldalnéveket URL-biztos útvonallá alakítja, miközben a látható linktextet érintetlenül hagyja. A mappa előtag az összes előállított útvonalhoz kerül, így az egybesimított wiki oldalak a docs/ vagy wiki/ mappa alá kerülhetnek anélkül, hogy minden linket szerkesztenél. A beágyazott képek (![[diagram.png]]) alapértelmezés szerint a szabályos linkekkel együtt konvertálódnak — kapcsold ki ezt a beállítást, ha csak a prózai linkeket kell átalakítani; a beágyazott képek soha nem kapják meg a célfájl kiterjesztést, mivel az kép már az eredeti kiterjesztésével rendelkezik.
Az átalakítás csak a [[…]] és a szabványos Markdown linkekre hat; a külső URL-ek, mailto: linkek és oldal belüli horgonyok érintetlenül maradnak, amikor Markdown-ből konvertálunk, mivel sosem voltak wiki linkek. A Windows és Unix sorvégződések egyaránt kezeltek, és a kimenet alatt az élő számláló mutatja, hány link lett konvertálva és az eredő karakterszám.
Minden helyileg fut a böngésződben — semmi, amit beillesztesz, nem kerül fel vagy nem kerül naplózásra. Másold a kimenetet, töltsd le .txt fájlként, vagy közvetlenül küldd vissza a bemenetbe a fordított irány alkalmazásához.