Skolenøkkelen

Fra OneNote til Markdown og Quarto

OneNote er godt egnet til å samle notater, bilder, håndskrift og vedlegg, men innholdet lagres ikke som vanlige tekstfiler. Det finnes derfor ingen perfekt konverteringsmetode som passer for alle notatblokker. Valg av metode avhenger blant annet av hvor mye innhold som skal flyttes, og hvor komplisert formateringen er.

Quarto-dokumenter bruker filendelsen .qmd. Innholdet skrives hovedsakelig i Markdown, men kan i tillegg inneholde blant annet kildehenvisninger, kryssreferanser, kodeblokker og Quarto-spesifikke funksjoner. En Markdown-fil kan derfor vanligvis tas i bruk som en Quarto-fil ved å endre filendelsen fra .md til .qmd og eventuelt legge til en tittel og annen metadata.

1. Kopiere og rydde manuelt

Den enkleste metoden er å kopiere innhold fra en OneNote-side og lime det inn i en teksteditor som støtter Markdown, for eksempel Visual Studio Code, Positron eller RStudio.

Denne metoden passer best når:

• bare noen få sider skal flyttes;
• sidene hovedsakelig består av tekst og enkle lister;
• man ønsker å kontrollere og forbedre strukturen underveis.

Etter innliming må overskrifter, lister, lenker og bilder ofte ryddes manuelt. OneNote kan også ta med skjult HTML-formatering som ikke er ønskelig i en Markdown-fil. Det kan derfor være nyttig å lime inn som ren tekst og deretter legge til Markdown-formatering:

# Hovedoverskrift

## Underoverskrift

- Første punkt
- Andre punkt

[Lenketekst](https://example.org)

Dette tar mest tid, men gir ofte det ryddigste sluttresultatet.

2. Eksportere til Word og konvertere med Pandoc

En praktisk metode for sider med tabeller, bilder og mer omfattende formatering er å eksportere eller kopiere OneNote-innholdet til et Word-dokument (.docx). Hvilke eksportvalg som er tilgjengelige, avhenger av OneNote-versjon og operativsystem.

Pandoc kan deretter konvertere Word-dokumentet til Markdown eller direkte til en .qmd-fil:

pandoc notater.docx \
  --from=docx \
  --to=markdown \
  --extract-media=media \
  --wrap=none \
  --output=notater.qmd

Valget --extract-media=media lagrer bilder og andre mediefiler i mappen media. Kontroller etterpå at bildelenkene peker til riktig sted.

Denne metoden bevarer vanligvis overskrifter, lister, lenker og enkle tabeller forholdsvis godt. Kompliserte tabeller, tekstbokser, tegninger og håndskrift kan kreve manuell etterbehandling.

3. Konvertere via HTML

OneNote-innhold kan også kopieres eller eksporteres til HTML før det konverteres med Pandoc. Dette kan være nyttig fordi OneNote internt representerer mye av sideinnholdet som HTML-lignende struktur.

pandoc side.html \
  --from=html \
  --to=markdown \
  --wrap=none \
  --output=side.qmd

HTML fra OneNote kan inneholde mye ekstra formatering. Resultatet bør derfor kontrolleres for unødvendige <div>- og <span>-elementer, tomme linjer og lokale skrifttyper.

4. Bruke et eget konverteringsverktøy

Det finnes tredjepartsverktøy og skript som kan eksportere hele OneNote-notatblokker til Markdown. Slike verktøy kan være nyttige når mange sider skal flyttes, fordi de ofte:

• oppretter én Markdown-fil per OneNote-side;
• lager mapper basert på inndelinger og sider;
• eksporterer bilder og vedlegg;
• forsøker å bevare interne lenker.

Før et slikt verktøy brukes, bør man undersøke om det støtter den aktuelle OneNote-versjonen, hvordan det håndterer innlogging, og om data sendes til en ekstern tjeneste. Ta alltid sikkerhetskopi av notatblokken først, og test med en liten inndeling før hele samlingen konverteres.

5. Automatisere med Microsoft Graph

Ved store eller gjentakende konverteringer kan OneNote-sider hentes gjennom Microsoft Graph API. API-et kan hente sideinnhold som HTML. Et skript kan deretter:

1. hente oversikten over notatblokker, inndelinger og sider;
2. laste ned HTML-innhold og bilder;
3. konvertere HTML til Markdown med Pandoc eller et programbibliotek;
4. opprette .qmd-filer med passende filnavn og metadata.

Denne løsningen krever registrering av en applikasjon i Microsoft Entra ID, nødvendige API-rettigheter og kode for å håndtere innlogging og filer. Metoden er derfor mest aktuell når prosessen skal gjentas eller omfatter svært mange sider.

Sammenligning av metodene

Metode	Passer best for	Fordeler	Begrensninger
Kopiere manuelt	Noen få, enkle sider	God kontroll og ryddig resultat	Tidkrevende ved store mengder
Word og Pandoc	Formaterte sider og dokumenter	Bevarer mye av strukturen	Krever ofte etterarbeid
HTML og Pandoc	Sider som kan lagres som HTML	Fleksibel og automatiserbar	Kan gi mye overflødig HTML
Tredjepartsverktøy	Hele notatblokker	Rask masseeksport	Kvalitet og støtte varierer
Microsoft Graph	Store eller gjentakende jobber	Kan automatiseres fullstendig	Krever programmering og API-oppsett

Anbefalt arbeidsflyt

For en mindre notatblokk er det ofte best å starte med Word og Pandoc, og deretter rydde resultatet manuelt. For bare noen få sider er direkte kopiering enklere. Ved svært mange sider bør et egnet eksportverktøy eller Microsoft Graph vurderes.

Uansett metode anbefales følgende arbeidsflyt:

1. Ta sikkerhetskopi av OneNote-notatblokken.
2. Test konverteringen på noen representative sider.
3. Lag en fast mappestruktur for .qmd-filer, bilder og vedlegg.
4. Kontroller overskrifter, tabeller, lenker, bilder og spesialtegn.
5. Del store sider opp i mindre kapitler dersom de skal inngå i en Quarto-bok.
6. Kjør quarto preview og kontroller resultatet i nettleseren.

Warning

Håndskrift, lydopptak, innebygde filer, matematiske uttrykk og avansert sideoppsett blir sjelden konvertert perfekt. Behold derfor originalmaterialet til det nye Quarto-prosjektet er kontrollert og sikkerhetskopiert.

Video