@unifast/vite

Genel Bakış

@unifast/vite, .md ve .mdx dosyalarını JavaScript modüllerine dönüştüren bir Vite plugin’idir. unifast’in Markdown/MDX derleyicisini Vite derleme ardışık düzenine entegre ederek Markdown dosyalarını doğrudan uygulamanıza import etmenize olanak tanır.

Kurulum

@unifast/node bir peer bağımlılıktır (isteğe bağlı) — mevcut olduğunda plugin, maksimum performans için native Rust derleyicisini kullanır. O olmadan .md dosyaları temel HTML render’a geri döner ve .mdx dosyaları onu gerektirir.

Hızlı Başlangıç

// vite.config.ts
import { defineConfig } from "vite";
import unifast from "@unifast/vite";

export default defineConfig({
  plugins: [
    unifast({
      md: {
        // .md dosyaları için derleme seçenekleri
      },
      mdx: {
        // .mdx dosyaları için derleme seçenekleri
      },
    }),
  ],
});

// App.tsx
import doc from "./content/hello.md";

console.log(doc.html);         // derlenmiş HTML string'i
console.log(doc.frontmatter);  // ayrıştırılmış frontmatter nesnesi
console.log(doc.toc);          // içindekiler tablosu girişleri

Modül Export’ları

.md dosyaları

Her .md dosyası aşağıdaki export’lara sahip bir modüle dönüştürülür:

.mdx dosyaları

Her .mdx dosyası, React’in jsx-runtime‘ı kullanılarak bir JSX modülüne derlenir. frontmatter ve toc ile birlikte varsayılan bir React bileşeni export eder.

Export Özeti