외부 링크에 아이콘 추가

rehype 플러그인을 사용하면 외부 사이트를 가리키는 Markdown 파일의 링크를 식별하고 수정할 수 있습니다. 이 예시에서는 방문자가 사이트를 떠난다는 것을 알 수 있도록 각 외부 링크 끝에 아이콘을 추가합니다.

전제 조건

섹션 제목: 전제 조건

• 콘텐츠 페이지에 Markdown을 사용하는 Astro 프로젝트가 필요합니다.

레시피

섹션 제목: 레시피

1. rehype-external-links 플러그인을 설치합니다.

   npm

   npm install rehype-external-links

   pnpm

   pnpm add rehype-external-links

   Yarn

   yarn add rehype-external-links

2. 플러그인을 astro.config.mjs 파일로 가져옵니다.

   content 속성이 포함된 옵션 객체와 함께 rehypeExternalLinks를 rehypePlugins 배열에 전달합니다. 링크 끝에 일반 텍스트를 추가하려면 이 속성의 type을 text로 설정하세요. 대신 링크 끝에 HTML을 추가하려면 type 속성을 raw로 설정하세요.

   // ...
   import rehypeExternalLinks from 'rehype-external-links';
   
   export default defineConfig({
     // ...
     markdown: {
       rehypePlugins: [
         [
           rehypeExternalLinks,
           {
             content: { type: 'text', value: ' 🔗' }
           }
         ],
       ]
     },
   });

   노트

   content 속성의 값은 접근성 트리에 표시되지 않습니다. 따라서 아이콘에만 의존하기보다는 링크가 주변 콘텐츠 외부에 있다는 점을 분명히 하는 것이 가장 좋습니다.

자료

섹션 제목: 자료

• rehype-external-links