TeXposit Tutorial

2. The Hybrid Format (.md)

Write simpler, cleaner documents using Pandoc-flavored Markdown + LaTeX.

6 min read Share

TeXposit allows you to use .md files as your main project files. These are powered by Pandoc 3.x, the "universal document converter," giving you a distraction-free writing experience without sacrificing LaTeX power.

Supported Features

Citations

Use [@key] syntax. Converted to \cite{key} using natbib.

Math

Standard $...$ and $$...$$ blocks work out of the box.

Tables

Standard Markdown pipe tables are converted to professional booktabs tables.

Code

Fenced code blocks are rendered using the listings package.

The "Zero-Preamble" Advantage

Unlike standard .tex files, a Hybrid .md file doesn't require a preamble. TeXposit automatically generates a professional academic layout (12pt, 1-inch margins) and handles section numbering for you.

Example: Markdown Simplicity, LaTeX Power

Source Code
Example OutputStatic
--- title: My Research Paper author: Jane Doe abstract: | This abstract is automatically formatted by the transpiler into a standard LaTeX abstract environment. --- # Introduction This is a Hybrid document. We can use **Markdown** for text, but still have full access to LaTeX. ## Citations & Math As noted in [@vaswani2017], the mechanism is key. In our case, $n_{features} = 128$. ## Images & Figures You can use standard Markdown syntax for images: ![Model Architecture](chart.png){#fig:model width=80%} ## Raw LaTeX Blocks Drop complex LaTeX anywhere: \begin{center} \begin{tabular}{lc} \toprule Metric & Value \\ \midrule Accuracy & 98.2% \\ \bottomrule \end{tabular} \end{center} \bibliography{references}

My Research Paper

Jane Doe

Abstract

This abstract is automatically formatted by the transpiler into a standard LaTeX abstract environment.

1 Introduction

This is a Hybrid document. We can use Markdown for text, but still have full access to LaTeX.

1.1 Citations & Math

As noted in [Vaswani et al., 2017], the mechanism is key. In our case, n_features = 128.

1.2 Images & Figures

[chart.png]

Figure 1: Model Architecture

1.3 Raw LaTeX Blocks

MetricValue
Accuracy98.2%
YAML Metadata
The block at the top fenced by --- is YAML metadata. Pandoc uses this to fill in the title, author, and date. You can even add an abstract field!