Utiliome

Kigeuzi cha Bure cha Mtandaoni cha Markdown hadi Confluence

Badilisha Markdown kuwa Confluence Storage Format & Wiki Markup bure mtandaoni. Zana ya faragha 100% kwenye kivinjari bila kujisajili wala kupakia server.

Pakia Faili ya Markdown

au udondoshe hapa

Initializing offline engine...

100% private in-browser workspace • Zero cloud uploads

Ingizo la Markdown
Matokeo ya Confluence

Zana Zinazohusiana

Zana ambazo unaweza pia kuhitaji

Kigeuzi cha Google Sheets hadi Markdown

Bandika seli kutoka Google Sheets au Excel na uzibadilishe papo hapo kuwa jedwali la Markdown.

Mhariri wa Markdown

Mhariri wa Markdown wa moja kwa moja wenye mwonekano wa papo hapo na uhamishaji wa HTML/maandishi.

Idadi ya Maneno na Muda wa Kusoma wa Markdown

Hesabu maneno, Herufi, aya, na vichwa katika Markdown bila kujumuisha sintaksia.

Mhariri wa YAML Frontmatter

Changanua, hariri na usasishe sehemu za YAML frontmatter za Jekyll, Hugo na Docusaurus.

Kizalishaji cha Yaliyomo cha Markdown

Zalisha jedwali la yaliyomo la Markdown lenye viunganishi vya mtindo wa GitHub na Jekyll.

Kizalishaji cha Sehemu Zinazokunjwa

Zalisha sehemu za maelezo zinazokunjwa zinazoendana na GitHub na GitLab.

Faragha 100% • Hakuna Kupakia Faili kwenye Server

Kwa nini Utumie Utiliome Bure Kigeuzi cha Bure cha Mtandaoni cha Markdown hadi Confluence?

Imejengwa kuanzia mwanzo kwa ajili ya faragha kamili, utekelezaji wa papo hapo, na bila vizuizi. Hakuna usajili au malipo yanayohitajika.

Ubadilishaji wa Faragha 100% Kwenye Kivinjari

Nyaraka zako, rasimu za nyaraka, na maelezo ya kiufundi hayatoki kwenye kifaa chako. Uchanganuzi na ubadilishaji wote kutoka Markdown hadi Confluence Storage Format (XHTML) au Confluence Wiki Markup unafanyika ndani ya kivinjari chako cha wavuti kwa kutumia JavaScript. Hakuna uchakataji wa server, hakuna kumbukumbu za data, na usalama wa juu wa kampuni.

Uumbaji wa Papo Hapo & Usaidizi wa Macro za Asili

Badilisha kwa urahisi GFM ya kawaida (GitHub Flavored Markdown), vitalu vya msimbo vyenye muundo wa rangi, jedwali, orodha za kazi, nukuu, na umbizo la ndani kuwa macro za asili za Confluence (kama vile Code Block, paneli za Taarifa/Onyo/Dokezo, na jedwali za XML).

Bila Kujisajili, Bila Vizuizi & Bure Kabisa

Ruka viunganishi vya gharama kubwa vya Atlassian Marketplace, ada za kila mwezi, na vizuizi vya kila siku. Utiliome inatoa ubadilishaji wa bure kabisa na usio na kikomo bila kufungua akaunti, bila barua pepe, na bila malipo ya siri.

Matokeo ya Aina Mbili: Confluence Storage Format & Wiki Markup

Iwe unanakili moja kwa moja kwenye mhariri wa kisasa wa Confluence Cloud kupitia XML ya mfumo wa kuhifadhi au unatumia Confluence Server/Data Center Wiki Markup ya zamani, zana yetu inazalisha matokeo yaliyoboreshwa kikamilifu kwa mazingira yote miwili kwa mbofyo mmoja.

Utiliome dhidi ya Njia Mbadala za Wingu

Lanisha injini yetu ya WebAssembly kwenye kivinjari chako dhidi ya zana za zamani za wingu.

Kipengele Utiliome (Kivinjari cha Mtaani) Vibadilisha vya Zamani vya Wingu
Faragha & Usalama wa Data Uchakataji wa 100% Ndani ya Kivinjari (Hakuna Kupakia Kwenye Server) Nyaraka hupakiwa kwenye server za watu wa tatu; hatari ya kuvuja kwa nyaraka za ndani
Bei & Leseni 100% Bure Milele Bila Ada Zilizofichwa Viunganishi vya kulipia vya Atlassian Marketplace ($1-$5/mtumiaji/mwezi) au zana za bure zenye vizuizi vikali
Sharti la Akaunti Hakuna Kujisajili au Barua Pepe Inayohitajika Inahitaji usajili wa mtumiaji, usanidi wa tokeni ya API, au OAuth ya kampuni
Vizuizi vya Matumizi Faili, Aya, & Idadi ya Herufi Isiyo na Kikomo Imezuiwa kwa ubadilishaji 3 kwa siku au urefu mdogo wa nyaraka
Ramani ya Macro ya Asili ya Confluence Ubadilishaji wa kiotomatiki wa vitalu vya msimbo, maonyo, jedwali & orodha za kazi Ubadilishaji wa msingi wa HTML unaoondoa mwangaza wa msimbo na kuharibu macro za Confluence

Jinsi ya Kutumia Kigeuzi cha Bure cha Mtandaoni cha Markdown hadi Confluence kwa Hatua 3 Rahisi

Hakuna usakinishaji wa programu unaohitajika. Kila kitu kinafanyika moja kwa moja ndani ya kivinjari chako.

1

Bandika au Pakia Document Yako ya Markdown

Nakili nyaraka zako za kiufundi, README.md, au maelezo moja kwa moja kwenye mhariri wa upande wa kushoto, au buruta na udondoshe faili ya `.md` kwenye eneo kazi la kivinjari.

2

Chagua Umbizo Lengo la Confluence & Hakiki

Chagua kati ya Confluence Storage Format (XHTML XML kwa Confluence Cloud ya kisasa) au Confluence Wiki Markup (kwa Server/Data Center ya zamani). Kagua mara moja muundo uliobadilishwa na hakiki ya HTML pembeni.

3

Nakili na Ubandike Moja kwa Moja kwenye Confluence

Bonyeza kitufe cha 'Nakili kwenye Ubao klip' au tumia sehemu ya 'Bandika kwenye Mhariri wa Confluence'. Fungua mhariri wa ukurasa wako wa Confluence na ubandike matokeo moja kwa moja ili kuchapisha nyaraka zilizoboreshwa.

Mwongozo Kamili wa Kubadilisha Markdown kuwa Confluence Storage Format Bila Viunganishi

Jibu la Haraka: Ili kubadilisha Markdown kuwa Confluence bila kusakinisha viunganishi vya kulipia au kupakia data nyeti za kampuni kwenye server za watu wa tatu, tumia kigeuzi cha Utiliome cha bure 100% cha Markdown hadi Confluence kinachofanya kazi kwenye kivinjari. Inabadilisha Markdown ya kawaida, GitHub Flavored Markdown (GFM), jedwali, na vitalu vya msimbo kuwa Confluence Storage Format XML au Wiki Markup moja kwa moja ndani ya kivinjari chako.

Timu za wahandisi, wasanifu wa programu, Wasimamizi wa bidhaa, na waandishi wa kiufundi wanategemea sana Markdown kuandaa nyaraka za kiufundi, kumbukumbu za maamuzi ya usanifu (ADR), miundo ya mfumo, na faili za README. Markdown ni nyepesi, inasomeka kwa urahisi, inadhibitiwa kwa matoleo kupitia Git, na inatumika kwa urahisi kote kwa waendelezaji. Hata hivyo, timu za makampuni mara nyingi hutumia Atlassian Confluence kama kituo chao kuu cha maarifa na wiki ya ndani. Kuziba pengo kati ya faili za Markdown zinazotokana na Git na kurasa za Confluence imekuwa mchakato mgumu kwa idara za uandishi wa programu.

Kwa Nini Kubadilisha Markdown kuwa Confluence ni Changamoto

Confluence haionyeshi moja kwa moja maandishi ghafi ya Markdown yaliyobandikwa kwenye mhariri wake wa wavuti. Confluence Cloud ya kisasa inatumia Atlassian Document Format (ADF) na Confluence Storage Format ya msingi (muundo wa XML unaotegemea XHTML), wakati Server na Data Center za zamani zinategemea Confluence Wiki Markup. Wakati waendelezaji wanapobandika Markdown ya kawaida moja kwa moja kwenye mhariri wa Confluence, vipengele vya kawaida vya umbizo huharibika:

  • Vitalu vya Msimbo Hupoteza Rangi za Msimbo: Vitalu vya msimbo vya kawaida (```python) vinakuwa maandishi ya kawaida yasiyo na umbizo, na kuondoa rangi za msimbo na ufafanuzi wa lugha.
  • Jedwali Kuharibika: Jedwali za Markdown zenye alama za kutenganisha (|) zinashindwa kuonyeshwa kama jedwali za HTML za Confluence, zikihitaji kuundwa upya kwa mikono kwa vichwa, safu mlalo, na safu wimbi.
  • Paneli za Maonyo na Taarifa Kuharibika: Nukuu maalum (> [!NOTE] au > [!WARNING]) zinakuwa nukuu za kawaida bila kisanduku cha Taarifa, Onyo, Dokezo, au Mafanikio chenye rangi cha Confluence.
  • Kisanduku cha Kazi na Orodha Kupoteza Mpangilio: Vipengele vya kazi vinavyoshughulikiwa (- [x] Task) vinakuwa orodha ya vitone vya maandishi na alama za vema badala ya visanduku vya kazi vya Confluence.
  • Mpangilio wa Vichwa na Viunganishi Kuharibika: Muundo wa vichwa (# H1, ## H2) unapoteza ramani ya jedwali la yaliyomo, ukiharibu viunganishi vya ndani kwenye makala ndefu za kiufundi.

Hatari ya Usalama ya Vigeuzi Vinavyotegemea Server za Watu wa Tatu

Zana nyingi maarufu za mtandaoni za kubadilisha Markdown zinachakata maandishi ya mtumiaji kwa kutuma maombi ya HTTP POST kwenye server za mbali. Waendelezaji wanapobadilisha nyaraka za ndani za programu, michoro ya miundombinu, funguo za API, miundo ya data, au kanuni za kampuni kwa kutumia vigeuzi vya mtandaoni, wanahatarisha kusambaza data nyeti za kampuni kupitia miundombinu ya watu wa tatu.

Sera za usalama za makampuni, viwango vya SOC 2, ISO 27001, na kanuni za HIPAA vinapiga marufuku kabisa kupakia nyaraka za msimbo wa ndani kwenye huduma za wavuti zisizothibitishwa. Utiliome inatatua hatari hii ya usalama kwa kuendesha injini yote ya uchanganuzi wa Markdown na ubadilishaji wa XHTML/XML ndani ya kivinjari chako cha wavuti. Kwa kutumia viwango vya kisasa vya JavaScript Web API, Web Workers, na mantiki ya ubadilishaji ya AST (Abstract Syntax Tree), maandishi yako ya Markdown hayatoki kwenye kivinjari chako. Hakuna maombi ya API yanayotumwa, hakuna hifadhidata za mbali zinazohifadhi taarifa zako, na hakuna miliki ya kampuni inayofichuliwa kwa server za nje.

Confluence Storage Format dhidi ya Confluence Wiki Markup: Kuelewa Matokeo

Wakati wahamisha nyaraka za waendelezaji kwenda Confluence, kuchagua umbizo sahihi la matokeo ni muhimu kwa ubadilishaji mzuri:

1. Confluence Storage Format (XHTML XML)

Confluence Storage Format ni umbizo la msingi la kuhifadhi linalotumiwa na Confluence Cloud na API za kisasa za REST. Inatumia majina maalum ya XML kama vile <ac:structured-macro>, <ac:parameter>, na <ac:rich-text-body>. Utiliome inachora vipengele vya kawaida vya Markdown kwenye sehemu sahihi za XML za Confluence:

  • Vitalu vya Msimbo: Vinatafsiriwa kuwa <ac:structured-macro ac:name="code"> zenye lebo za vigezo zinazofafanua lugha sahihi (m.f., python, typescript, bash, json, yaml).
  • Paneli za Maonyo: Maonyo ya Markdown yanatafsiriwa kuwa <ac:structured-macro ac:name="info">, warning, note, au tip zenye vichwa maalum na maandishi ya HTML yaliyoboreshwa.
  • Jedwali za Data: Jedwali za Markdown zinabadilishwa kuwa miundo ya <table> ya XHTML yenye vichwa vya <th> vilivyoboreshwa na seli za data za <td> safi.

2. Confluence Wiki Markup

Confluence Wiki Markup ni muundo wa kawaida wa maandishi unaotumiwa kwenye Server za zamani za Confluence, Data Center, na macro maalum za kuingiza (kama vile Insert > Markup). Inatumia alama fupi kama {code:python}...{code}, {note}...{note}, na h2. Heading Title. Kigeuzi cha Utiliome kinakuruhusu kubadilisha mara moja kati ya Storage Format XML na Wiki Markup bila kuchelewa.

Hatua kwa Hatua za Mchakato wa Kiofisi wa Kusawazisha Nyaraka

Kujumuisha ubadilishaji wa Markdown hadi Confluence kwenye mchakato wako wa kila siku wa uendelezaji inachukua chini ya sekunde 30:

  1. Andaa chanzo chako cha Markdown: Andika maelezo yako ya kiufundi, maelezo ya toleo jipya, au tathmini ya kazi kwenye VS Code, Obsidian, GitHub, au mhariri wowote wa maandishi.
  2. Fungua Kigeuzi cha Bure cha Utiliome: Nenda kwenye ukurasa wa kigeuzi kwenye kivinjari chochote cha kisasa (Chrome, Firefox, Safari, Edge).
  3. Bandika au Dondosha Faili Yako: Weka maandishi yako kwenye mhariri. Hakiki ya moja kwa moja inasasishwa papo hapo unapochapa au kubandika.
  4. Chagua Njia ya Matokeo: Bonyeza kichupo cha matokeo kinacholingana na Confluence yako (Storage Format XML kwa Confluence Cloud au Wiki Markup kwa Server/Data Center).
  5. Bandika kwenye Confluence: Fungua ukurasa wako lengo wa Confluence katika hali ya kuhariri, bonyeza Insert > Markup (au bandika umbizo la kuhifadhi moja kwa moja kupitia viunganishi vya chanzo), na uchapishe nyaraka zako vizuri.

Chambuzi ya Kina ya Vipengele: Jinsi Vipengele vya Markdown Vinavyochorwa kwenye Macro za Asili za Confluence

Jibu la Haraka: Utiliome inatafsiri kiotomatiki miundo ya kawaida ya GitHub Flavored Markdown (GFM) kuwa macro za asili za Confluence. Vitalu vya msimbo vinachorwa kwenye macro za Code Block za Confluence, nukuu zinachorwa kwenye paneli za Taarifa/Dokezo/Onyo, orodha za kazi zinachorwa kwenye vipengele vya kazi vya Confluence, na jedwali zinachorwa kwenye jedwali za XML.

Ili kutoa nyaraka tayari kwa matumizi zinazoonekana kama zimeundwa ndani ya Confluence, Utiliome inafanya uchanganuzi wa hali ya juu wa Abstract Syntax Tree (AST). Hapa chini ni uchanganuzi wa kiufundi wa jinsi mfumo maalum wa Markdown unavyobadilishwa kuwa vipengele vya asili vya Confluence:

1. Vitalu vya Msimbo & Rangi za Msimbo

Katika Markdown ya kawaida, vitalu vya msimbo vinatambuliwa kwa kutumia alama tatu za ``` zikifuatiwa na lugha kwa hiari:

```typescript
interface UserProfile {
  id: string;
  email: string;
  role: 'admin' | 'user';
}

Inapochakatwa na Utiliome kwa Confluence Storage Format, kitalu hiki kinabadilishwa kuwa Macro ya Msimbo ya Atlassian:
```xml
<ac:structured-macro ac:name="code" ac:schema-version="1">
  <ac:parameter ac:name="language">typescript</ac:parameter>
  <ac:parameter ac:name="linenumbers">true</ac:parameter>
  <ac:plain-text-body><![CDATA[interface UserProfile {
  id: string;
  email: string;
  role: 'admin' | 'user';
}]]></ac:plain-text-body>
</ac:structured-macro>

Hii inahakikisha kwamba ikichapishwa kwenye Confluence, msimbo wako unahifadhi nambari za mistari, rangi kamili za msimbo, uwezo wa kufanya kazi kwenye muonekano mweusi au mweupe, na kitufe cha asili cha 'Nakili Msimbo' kinachotolewa na Atlassian.

2. Maonyo ya GitHub & Paneli za Confluence

Majukwaa ya kisasa ya nyaraka kama GitHub na GitLab yanaunga mkono maonyo ndani ya nukuu. Utiliome inatambua miundo hii na kuitafsiri kuwa paneli sahihi za Confluence:

Muundo wa Onyo wa Markdown Macro Lengo ya Confluence Muonekano kwenye Confluence
> [!NOTE] au > [!INFO] <ac:structured-macro ac:name="info"> Bango la bluu lenye alama ya taarifa
> [!TIP] <ac:structured-macro ac:name="tip"> Bango la kijani lenye alama ya taa
> [!WARNING] au > [!CAUTION] <ac:structured-macro ac:name="warning"> Bango la dilp/machungwa lenye alama ya onyo
> [!IMPORTANT] <ac:structured-macro ac:name="note"> Bango la nyekundu/zambarau lenye alama ya dokezo

Mfano, Markdown ifuatayo:

> [!WARNING]
> Matengenezo ya hifadhidata yatafanyika Jumapili saa 02:00 UTC. Tarajia hadi dakika 15 za mfumo kufungwa.

Inabadilishwa kiotomatiki kuwa kisanduku cha Onyo cha Confluence, ikionyesha kisanduku safi cha maonyo kwenye Confluence bila kuhitaji usanidi wa mikono.

3. Jedwali za Data Zilizopangwa

Jedwali za Markdown zenye viashiria vya mpangilio (:---, :---:, ---:) mara nyingi zinaharibika zikinakiliwa kwa mikono. Utiliome inachanganua jedwali hizi kuwa jedwali safi za XHTML zenye mpangilio sahihi wa vichwa na nafasi za seli:

| Jina la Huduma | Port | Sehemu ya Kukagua Afya | Hali |
| :--- | :---: | :--- | :---: |
| Auth Service | 8080 | `/healthz` | Inafanya kazi |
| Payment Gateway | 8081 | `/status` | Inafanya kazi |

Matokeo ya Storage Format yaliyobadilishwa:

<table>
  <thead>
    <tr>
      <th style="text-align: left;">Jina la Huduma</th>
      <th style="text-align: center;">Port</th>
      <th style="text-align: left;">Sehemu ya Kukagua Afya</th>
      <th style="text-align: center;">Hali</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td style="text-align: left;">Auth Service</td>
      <td style="text-align: center;">8080</td>
      <td style="text-align: left;">/healthz</td>
      <td style="text-align: center;">Inafanya kazi</td>
    </tr>
    <tr>
      <td style="text-align: left;">Payment Gateway</td>
      <td style="text-align: center;">8081</td>
      <td style="text-align: left;">/status</td>
      <td style="text-align: center;">Inafanya kazi</td>
    </tr>
  </tbody>
</table>

4. Orodha za Kazi Zinazoshughulikiwa

Orodha za kazi kwenye Markdown (- [ ] na - [x]) zinachorwa moja kwa moja kwenye macro ya orodha ya kazi ya Confluence (<ac:task-list>), ikiwezesha wajumbe wa timu kutia alama kwenye kazi zilizokamilika moja kwa moja kwenye ukurasa wa Confluence uliochapishwa.

5. Samani za Hisabati & Michoro

Utiliome inaunga mkono maelezo ya KaTeX/LaTeX ($E = mc^2$) na samani za hisabati za vitalu ($$\sum_{i=1}^{n} i = \frac{n(n+1)}{2}$$), ikizibadilisha kuwa macro za LaTeX/Math za Confluence ili nyaraka tata za kisayansi na kifedha zionyeshwe kwa usahihi.

Mbinu Bora za Kuhifadhi Nyaraka za Kiufundi Kwenye Git & Confluence

Ili kuhifadhi chanzo kimoja cha ukweli kwenye hifadhi za Git na kurasa za Confluence, mashirika makuu ya uandishi wa programu yanafuata mbinu hizi rahisi:

  • Hifadhi Faili za Chanzo Kwenye Git: Hifadhi nyaraka zote za muundo wa mfumo kama faili za .md ndani ya hifadhi ya programu pamoja na msimbo.
  • Tumia Utiliome kwa Ubadilishaji: Unapochapisha maelezo ya toleo jipya au viwango vya kiufundi, endesha Markdown kupitia kigeuzi cha faragha cha Utiliome.
  • Epuka Kuhariri kwa Mikono Kwenye Confluence: Chukulia Confluence kama sehemu ya kusoma tu kwa nyaraka zinazodhibitiwa na Git ili kuzuia tofauti za usanidi kati ya msimbo na nyaraka.
  • Weka Viwango vya Macro: Tegemea vipengele vya kawaida vya GFM kama vile maonyo, jedwali, na vitalu vya msimbo ili kuhakikisha ubadilishaji bora wa 100% kila wakati.

Kigeuzi cha Bure cha Mtandaoni cha Markdown hadi Confluence Maswali ya Mara kwa Mara na Mwongozo wa Kiufundi

Kila kitu unachohitaji kujua kuhusu kutumia Utiliome ya bure mtandaoni kigeuzi cha bure cha mtandaoni cha markdown hadi confluence.

Je, nyaraka zangu zinapakiwa kwenye server yoyote ya nje wakati wa ubadilishaji?

Hapana. Utiliome inafanya kazi chini ya mfumo thabiti wa uchakataji wa 100% ndani ya kivinjari. Mantiki yote ya ubadilishaji inaendeshwa ndani ya mfumo wa JavaScript wa kivinjari chako. Maandishi yako ya Markdown, msimbo wa kampuni, na nyaraka za ndani hazitumwi kwa server za nje, hazihifadhiwi kwenye hifadhidata za mtandaoni, wala hazirekodiwi mahali popote.

Ninabandikaje Markdown iliyobadilishwa kwenye Confluence Cloud?

Kwa Confluence Cloud, nakili matokeo ya 'Confluence Storage Format (XHTML XML)' yaliyotolewa na Utiliome. Kwenye mhariri wa ukurasa wa Confluence, fungua menyu ya 'Ingiza' (alama ya +), chagua 'Markup' (au bonyeza Ctrl+Shift+D / Cmd+Shift+D), chagua 'Confluence Storage Format' au 'Markdown', bandika msimbo, na ubonyeze 'Ingiza'.

Je, zana hii inaunga mkono GitHub Flavored Markdown (GFM)?

Ndiyo! Utiliome inaunga mkono kikamilifu GitHub Flavored Markdown (GFM), ikijumuisha vitalu vya msimbo vyenye rangi, jedwali, orodha za kazi, maandishi yaliyokatwa, viunganishi vya kiotomatiki, na maonyo ya GitHub (> [!NOTE], > [!WARNING]).

Je, kuna vizuizi vya ukubwa wa faili au matumizi?

Hakuna kabisa. Utiliome ni bure kabisa bila vizuizi vya matumizi, bila kikomo cha herufi, na bila viwango vya kila siku. Kwa sababu uchakataji unafanyika kwenye kompyuta yako, unaweza kubadilisha nyaraka za ukubwa wowote mara moja.

Kwa nini nitumie Utiliome badala ya viunganishi vya kulipia vya Atlassian Marketplace?

Viunganishi vya Atlassian Marketplace mara nyingi vinagharimu ada za kila mwezi kwa kila mtumiaji, vinahitaji kibali cha msimamizi kusakinishwa, na vinaweza kupunguza kasi ya Confluence yako. Utiliome inatoa mbadala wa papo hapo, wa bure, na wa faragha usiohitaji usakinishaji, kibali cha msimamizi, wala usajili.