xidoc

xidoc is a consistent and powerful text language for creating documents.

It compiles to HTML, L^aT_eX and Gemtext, allowing you to create a webpage, a professional-looking PDF and a Gemini page from a single source file.

A Quick Look

For a more interactive experience, try the online playground.

xidoc code

[def greet; target; Hello from xidoc compiled to [arg target]!]
[p
  [if-html [greet HTML]]
  [if-latex [greet [LaTeX]]]
  [if-gemtext [greet Gemtext]]
  We have [code python; print("code")],
  [$ m \mathbf A^\mathrm{T} \vec h],
  [pikchr 4rem; ellipse "pictures" fit color lime],
  [js-eval "ytilibammargorp".split("").reverse().join("")]
  and more!
]

Output

Hello from xidoc compiled to HTML! We have print("code"), $m \mathbf A^\mathrm{T} \vec h$ , , programmability and more!

Features

Extremely simple syntax with only three special characters
Typeset mathematics, highlight source code, draw simple diagrams and more
Easily define your own commands
Programmable with JavaScript or Janet
Friendly error messages
Tree-sitter integration

What can I do with xidoc?

Make a website (such as this one)
Make the front-end of a web app
Write your school notes
Write an article
Write a book
Flex your skills at learning obscure languages

Source Code

xidoc is available on

SourceHut and

GitHub under the GNU General Public Licence 3. (SourceHut is strongly preferred because it is important for free software to use free software infrastructure.)