#25 Tech Writer koduje w dokumentacji, czyli Markdown w wersji rozszerzonej

Tech Writer koduje

Markdown to prosty i lekki język znaczników, który w ostatnich latach zyskał sporą popularność, szczególnie w świecie dokumentacji dla programistów. Pozwala nam on łatwo i szybko stworzyć tekst, a następnie opublikować go jako HTML. Z biegiem czasu pojawiły się różne odmiany i rozszerzenia Markdowna, pozwalające wycisnąć z niego jeszcze więcej. Jednym z nich jest MDX, który pozwala na używanie bezpośrednio w tekście elementów JSX. Takie rozwiązanie otwiera przed nami nowe możliwości, jak na przykład opcję umieszczenia w dokumentacji interaktywnej próbki kodu. Dzięki temu możemy przesunąć naszą dokumentację na wyższy poziom. Rozmawiamy o tym czym jest MDX, jakie daje nam możliwości i w jakich sytuacjach może nam się przydać.

Muzyka w intro oraz dźwięki pochodzą z kolekcji "107 Free Retro Game Sounds" dostępnej na stronie https://dominik-braun.net, udostępnianej na podstawie licencji Creative Commons license CC BY 4.0.

Informacje dodatkowe:

Markdown: https://daringfireball.net/projects/markdown/syntax

MDX: https://mdxjs.com/

Wprowadzenie do JSX: https://pl.reactjs.org/docs/introducing-jsx.html

React: https://pl.reactjs.org/

"What is a Static Site Generator? And 3 ways to find the best one": https://www.netlify.com/blog/2020/04/14/what-is-a-static-site-generator-and-3-ways-to-find-the-best-one/

Docusaurus v2: https://v2.docusaurus.io/

Gatsby: https://www.gatsbyjs.com/

Next.js: https://nextjs.org/

Create React app: https://github.com/facebook/create-react-app

Carbon React: https://react.carbondesignsystem.com/

React Bootstrap: https://react-bootstrap.github.io/

Swagger UI: https://swagger.io/tools/swagger-ui/

webpack: https://webpack.js.org/