obsidian-export 0.1.0__tar.gz

obsidian_export-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.pixi/
+pixi.lock
+.mmdc/
+.pytest_cache/
+.hypothesis/

obsidian_export-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matthias Christenson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

obsidian_export-0.1.0/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: obsidian-export
+Version: 0.1.0
+Summary: Convert Obsidian-flavored Markdown to PDF and DOCX via a 5-stage pipeline
+Project-URL: Repository, https://github.com/neuralsignal/obsidian-export
+Author: Matthias Christenson
+License-Expression: MIT
+License-File: LICENSE
+Keywords: converter,docx,export,markdown,obsidian,pandoc,pdf
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Requires-Python: >=3.12
+Requires-Dist: click<9,>=8.0
+Requires-Dist: pyyaml<7,>=6.0
+Provides-Extra: dev
+Requires-Dist: hypothesis<7,>=6.0; extra == 'dev'
+Requires-Dist: pytest-cov<6,>=5.0; extra == 'dev'
+Requires-Dist: pytest<9,>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# obsidian-export
+
+Convert Obsidian-flavored Markdown to PDF and DOCX. Handles wikilinks, embeds, callouts, Mermaid diagrams, and frontmatter — producing clean, professional documents via a 5-stage pipeline (vault ops → preprocess → mermaid → SVG → pandoc).
+
+## Install
+
+```bash
+pip install obsidian-export
+```
+
+### System Dependencies
+
+| Dependency | Required | Purpose |
+|-----------|----------|---------|
+| [pandoc](https://pandoc.org/) >= 3.5 | Yes | Markdown to PDF/DOCX conversion |
+| [tectonic](https://tectonic-typesetting.github.io/) >= 0.15 | Yes (PDF) | XeLaTeX PDF engine |
+| [Node.js](https://nodejs.org/) >= 20 | Optional | Runtime for Mermaid CLI |
+| [librsvg](https://wiki.gnome.org/Projects/LibRsvg) | Optional | SVG to PDF conversion |
+
+Check your setup:
+
+```bash
+obsidian-export doctor
+```
+
+## Quick Start
+
+```bash
+# Convert with default settings
+obsidian-export convert --input my_note.md --format pdf --output my_note.pdf
+
+# Convert to DOCX
+obsidian-export convert --input my_note.md --format docx --output my_note.docx
+
+# Use a custom profile
+obsidian-export convert --input my_note.md --format pdf --output my_note.pdf --profile my_brand
+```
+
+## Profile Management
+
+Profiles are YAML config files stored in `~/.obsidian-export/profiles/`.
+
+```bash
+# Initialize directory structure and default profile
+obsidian-export init
+
+# Create a new profile (starts from defaults)
+obsidian-export profile create my_brand
+
+# Create from existing YAML
+obsidian-export profile create my_brand --from existing_config.yaml
+
+# List profiles
+obsidian-export profile list
+
+# Show profile contents
+obsidian-export profile show my_brand
+
+# Delete a profile
+obsidian-export profile delete my_brand --yes
+```
+
+## Custom Styles
+
+Styles are LaTeX header templates. Place custom styles in `~/.obsidian-export/styles/<name>/header.tex`.
+
+Style resolution order:
+1. `style_dir` field in config (explicit path)
+2. Built-in styles (`default`)
+3. User styles in `~/.obsidian-export/styles/<name>/`
+4. Treat style name as a filesystem path
+
+## Configuration
+
+A config YAML can override any subset of defaults. Only include fields you want to change:
+
+```yaml
+# Minimal override — everything else uses defaults
+style:
+  fontsize: "12pt"
+  mainfont: "Georgia"
+  line_spacing: 1.5
+```
+
+### Full Config Reference
+
+```yaml
+mermaid:
+  mmdc_bin: "mmdc"          # Path to Mermaid CLI binary
+  scale: 3                  # PNG render scale
+
+obsidian:
+  wikilink_strategy: "text"           # How to handle [[wikilinks]]
+  url_strategy: "footnote_long"       # bare URL handling: keep|footnote_long|footnote_all|strip
+  url_length_threshold: 60            # URL length for footnote_long strategy
+
+pandoc:
+  from_format: "gfm-tex_math_dollars" # Pandoc input format
+
+style:
+  name: "default"                     # Style name (resolves to header.tex template)
+  geometry: "a4paper,margin=25mm"     # Page geometry
+  fontsize: "10pt"                    # Base font size
+  mainfont: ""                        # Main font (XeLaTeX)
+  sansfont: ""                        # Sans font
+  monofont: ""                        # Mono font
+  linkcolor: "NavyBlue"              # Internal link color
+  urlcolor: "NavyBlue"               # URL color
+  line_spacing: 1.0                  # Line spacing multiplier
+  table_fontsize: "small"            # Font size in tables
+  image_max_height_ratio: 0.40       # Max image height as fraction of page
+  url_footnote_threshold: 60         # URL length threshold for footnoting
+  header_left: ""                    # Left header (supports {doc_title}, {logo_path})
+  header_right: ""                   # Right header
+  footer_left: ""                    # Left footer
+  footer_center: "\\thepage"         # Center footer
+  footer_right: ""                   # Right footer
+  logo: ""                           # Logo filename (relative to style dir)
+  style_dir: ""                      # Explicit style directory path
+  callout_colors:
+    note: [219, 234, 254]
+    tip: [220, 252, 231]
+    warning: [254, 243, 199]
+    danger: [254, 226, 226]
+```
+
+## Python API
+
+```python
+from pathlib import Path
+from obsidian_export import run
+from obsidian_export.config import default_config, load_config
+
+# Using defaults
+config = default_config()
+run(Path("my_note.md"), Path("output.pdf"), "pdf", config)
+
+# Using a config file
+config = load_config(Path("my_config.yaml"))
+run(Path("my_note.md"), Path("output.pdf"), "pdf", config)
+```
+
+## What It Does
+
+| Obsidian Syntax | Result |
+|----------------|--------|
+| `![[embed]]` | Resolved inline (content inlined) |
+| `[[Entity\|Display]]` | Replaced with `Display` |
+| `[[Entity]]` | Replaced with `Entity` |
+| `> [!note]` callouts | Colored boxes (PDF) or blockquotes (DOCX) |
+| `` ```mermaid `` | Rendered to PNG |
+| `## Relations` section | Removed |
+| YAML frontmatter | Title extracted, tags → keywords, rest removed |
+| `$25/user` | Safe literal dollar sign |
+
+## License
+
+MIT

obsidian_export-0.1.0/README.md

@@ -0,0 +1,158 @@
+# obsidian-export
+
+Convert Obsidian-flavored Markdown to PDF and DOCX. Handles wikilinks, embeds, callouts, Mermaid diagrams, and frontmatter — producing clean, professional documents via a 5-stage pipeline (vault ops → preprocess → mermaid → SVG → pandoc).
+
+## Install
+
+```bash
+pip install obsidian-export
+```
+
+### System Dependencies
+
+| Dependency | Required | Purpose |
+|-----------|----------|---------|
+| [pandoc](https://pandoc.org/) >= 3.5 | Yes | Markdown to PDF/DOCX conversion |
+| [tectonic](https://tectonic-typesetting.github.io/) >= 0.15 | Yes (PDF) | XeLaTeX PDF engine |
+| [Node.js](https://nodejs.org/) >= 20 | Optional | Runtime for Mermaid CLI |
+| [librsvg](https://wiki.gnome.org/Projects/LibRsvg) | Optional | SVG to PDF conversion |
+
+Check your setup:
+
+```bash
+obsidian-export doctor
+```
+
+## Quick Start
+
+```bash
+# Convert with default settings
+obsidian-export convert --input my_note.md --format pdf --output my_note.pdf
+
+# Convert to DOCX
+obsidian-export convert --input my_note.md --format docx --output my_note.docx
+
+# Use a custom profile
+obsidian-export convert --input my_note.md --format pdf --output my_note.pdf --profile my_brand
+```
+
+## Profile Management
+
+Profiles are YAML config files stored in `~/.obsidian-export/profiles/`.
+
+```bash
+# Initialize directory structure and default profile
+obsidian-export init
+
+# Create a new profile (starts from defaults)
+obsidian-export profile create my_brand
+
+# Create from existing YAML
+obsidian-export profile create my_brand --from existing_config.yaml
+
+# List profiles
+obsidian-export profile list
+
+# Show profile contents
+obsidian-export profile show my_brand
+
+# Delete a profile
+obsidian-export profile delete my_brand --yes
+```
+
+## Custom Styles
+
+Styles are LaTeX header templates. Place custom styles in `~/.obsidian-export/styles/<name>/header.tex`.
+
+Style resolution order:
+1. `style_dir` field in config (explicit path)
+2. Built-in styles (`default`)
+3. User styles in `~/.obsidian-export/styles/<name>/`
+4. Treat style name as a filesystem path
+
+## Configuration
+
+A config YAML can override any subset of defaults. Only include fields you want to change:
+
+```yaml
+# Minimal override — everything else uses defaults
+style:
+  fontsize: "12pt"
+  mainfont: "Georgia"
+  line_spacing: 1.5
+```
+
+### Full Config Reference
+
+```yaml
+mermaid:
+  mmdc_bin: "mmdc"          # Path to Mermaid CLI binary
+  scale: 3                  # PNG render scale
+
+obsidian:
+  wikilink_strategy: "text"           # How to handle [[wikilinks]]
+  url_strategy: "footnote_long"       # bare URL handling: keep|footnote_long|footnote_all|strip
+  url_length_threshold: 60            # URL length for footnote_long strategy
+
+pandoc:
+  from_format: "gfm-tex_math_dollars" # Pandoc input format
+
+style:
+  name: "default"                     # Style name (resolves to header.tex template)
+  geometry: "a4paper,margin=25mm"     # Page geometry
+  fontsize: "10pt"                    # Base font size
+  mainfont: ""                        # Main font (XeLaTeX)
+  sansfont: ""                        # Sans font
+  monofont: ""                        # Mono font
+  linkcolor: "NavyBlue"              # Internal link color
+  urlcolor: "NavyBlue"               # URL color
+  line_spacing: 1.0                  # Line spacing multiplier
+  table_fontsize: "small"            # Font size in tables
+  image_max_height_ratio: 0.40       # Max image height as fraction of page
+  url_footnote_threshold: 60         # URL length threshold for footnoting
+  header_left: ""                    # Left header (supports {doc_title}, {logo_path})
+  header_right: ""                   # Right header
+  footer_left: ""                    # Left footer
+  footer_center: "\\thepage"         # Center footer
+  footer_right: ""                   # Right footer
+  logo: ""                           # Logo filename (relative to style dir)
+  style_dir: ""                      # Explicit style directory path
+  callout_colors:
+    note: [219, 234, 254]
+    tip: [220, 252, 231]
+    warning: [254, 243, 199]
+    danger: [254, 226, 226]
+```
+
+## Python API
+
+```python
+from pathlib import Path
+from obsidian_export import run
+from obsidian_export.config import default_config, load_config
+
+# Using defaults
+config = default_config()
+run(Path("my_note.md"), Path("output.pdf"), "pdf", config)
+
+# Using a config file
+config = load_config(Path("my_config.yaml"))
+run(Path("my_note.md"), Path("output.pdf"), "pdf", config)
+```
+
+## What It Does
+
+| Obsidian Syntax | Result |
+|----------------|--------|
+| `![[embed]]` | Resolved inline (content inlined) |
+| `[[Entity\|Display]]` | Replaced with `Display` |
+| `[[Entity]]` | Replaced with `Entity` |
+| `> [!note]` callouts | Colored boxes (PDF) or blockquotes (DOCX) |
+| `` ```mermaid `` | Rendered to PNG |
+| `## Relations` section | Removed |
+| YAML frontmatter | Title extracted, tags → keywords, rest removed |
+| `$25/user` | Safe literal dollar sign |
+
+## License
+
+MIT

obsidian_export-0.1.0/obsidian_export/__init__.py

@@ -0,0 +1,117 @@
+"""obsidian-export: Obsidian -> PDF/DOCX pipeline.
+
+Public API:
+    run(input_path, output_path, output_format, config) -> None
+"""
+
+import tempfile
+from pathlib import Path
+
+from obsidian_export.config import ConvertConfig, StyleConfig
+from obsidian_export.pipeline.latex_header import render_header
+from obsidian_export.pipeline.stage1_vault import (
+    clean_frontmatter,
+    parse_frontmatter,
+    resolve_embeds,
+    strip_leading_title,
+    strip_obsidian_syntax,
+)
+from obsidian_export.pipeline.stage2_preprocess import preprocess
+from obsidian_export.pipeline.stage3_mermaid import render_mermaid_blocks
+from obsidian_export.pipeline.stage3_svg import convert_svg_images
+from obsidian_export.pipeline.stage4_pandoc import convert_to_docx, convert_to_pdf
+from obsidian_export.profiles import USER_STYLES_DIR
+
+
+def _resolve_style_dir(style: StyleConfig) -> Path:
+    """Resolve style directory.
+
+    Resolution order:
+    1. style.style_dir if set (absolute or relative path)
+    2. Built-in assets/styles/<name>/
+    3. ~/.obsidian-export/styles/<name>/
+    4. Treat style.name as an absolute/relative path
+    """
+    # Explicit style_dir override
+    if style.style_dir:
+        candidate = Path(style.style_dir)
+        if candidate.is_dir():
+            return candidate
+        raise FileNotFoundError(f"Style dir not found: {style.style_dir!r}")
+
+    name = style.name
+
+    # Built-in styles
+    builtin = Path(__file__).parent / "assets" / "styles" / name
+    if builtin.is_dir():
+        return builtin
+
+    # User styles
+    user = USER_STYLES_DIR / name
+    if user.is_dir():
+        return user
+
+    # Treat as path
+    candidate = Path(name)
+    if candidate.is_dir():
+        return candidate
+
+    raise FileNotFoundError(f"Style not found: {name!r} (checked {builtin}, {user}, and {candidate})")
+
+
+def run(
+    input_path: Path,
+    output_path: Path,
+    output_format: str,
+    config: ConvertConfig,
+) -> None:
+    """Full pipeline: Stage 1 -> Stage 2 -> Stage 3 -> Stage 4.
+
+    input_path:    absolute path to source .md file
+    output_path:   absolute path for output file (parent dirs created automatically)
+    output_format: "pdf" or "docx"
+    config:        fully-populated ConvertConfig (no defaults)
+    """
+    if output_format not in ("pdf", "docx"):
+        raise ValueError(f"Unsupported output format: {output_format!r}. Use 'pdf' or 'docx'.")
+
+    source = input_path.read_text(encoding="utf-8")
+
+    # Stage 1: Vault operations
+    fm, body = parse_frontmatter(source)
+    fm = clean_frontmatter(fm)
+    # .get() intentional: title is genuinely optional in frontmatter;
+    # many knowledge notes omit it, so we fall back to the filename stem.
+    title = str(fm.get("title", input_path.stem))
+    body = strip_leading_title(body, title)
+    vault_root = input_path.parent
+    body = resolve_embeds(body, vault_root, input_path)
+    body = strip_obsidian_syntax(body)
+
+    # Stage 2: Text-level pre-processing
+    body = preprocess(body, config.obsidian)
+
+    # Stage 3: Mermaid diagram rendering
+    with tempfile.TemporaryDirectory() as tmpdir:
+        body = render_mermaid_blocks(body, config.mermaid, Path(tmpdir))
+
+        # Stage 3b: SVG -> PDF conversion (PDF output only)
+        if output_format == "pdf":
+            body = convert_svg_images(body, Path(tmpdir))
+
+        # Stage 4: Pandoc conversion
+        if output_format == "pdf":
+            style_dir = _resolve_style_dir(config.style)
+            filters_dir = Path(__file__).parent / "assets" / "filters"
+            rendered_header = render_header(config.style, style_dir / "header.tex", title)
+            convert_to_pdf(
+                body,
+                title,
+                config.pandoc,
+                config.style,
+                rendered_header,
+                filters_dir,
+                output_path,
+            )
+        else:
+            convert_to_docx(body, title, config.pandoc, output_path)

obsidian_export-0.1.0/obsidian_export/assets/filters/callout_boxes.lua

@@ -0,0 +1,33 @@
+-- callout_boxes.lua
+-- Convert Pandoc fenced divs (.note, .tip, .warning, .danger, etc.) to
+-- tcolorbox LaTeX environments. Only applies when outputting LaTeX (PDF).
+if FORMAT ~= "latex" then return {} end
+
+local callout_colors = {
+  note      = "noteblue",
+  info      = "noteblue",
+  tip       = "tipgreen",
+  success   = "tipgreen",
+  warning   = "warnyellow",
+  caution   = "warnyellow",
+  danger    = "dangerred",
+  important = "dangerred",
+  error     = "dangerred",
+}
+
+function Div(el)
+  for class, color in pairs(callout_colors) do
+    if el.classes:includes(class) then
+      local title = el.attributes["title"] or (class:sub(1,1):upper() .. class:sub(2))
+      -- Render inner content to LaTeX
+      local inner_doc = pandoc.Pandoc(el.content)
+      local inner_latex = pandoc.write(inner_doc, "latex")
+      local latex = string.format(
+        "\\begin{calloutbox}{%s}{%s}\n%s\\end{calloutbox}\n",
+        color, title, inner_latex
+      )
+      return pandoc.RawBlock("latex", latex)
+    end
+  end
+  return el
+end

obsidian_export-0.1.0/obsidian_export/assets/filters/center_figures.lua

@@ -0,0 +1,18 @@
+-- center_figures.lua
+-- Promote standalone images (lone image in a paragraph) to centered
+-- LaTeX figure environments. Needed because GFM (--from=gfm) treats
+-- all images as inline; pandoc never emits \begin{figure}, so
+-- \AtBeginEnvironment{figure}{\centering} has no effect.
+if FORMAT ~= "latex" then return {} end
+
+function Para(el)
+  if #el.content == 1 and el.content[1].t == "Image" then
+    local img = el.content[1]
+    return pandoc.RawBlock("latex",
+      "\\begin{figure}[H]\n" ..
+      "\\centering\n" ..
+      "\\includegraphics[width=\\maxwidth,height=\\maxheight,keepaspectratio]{" .. img.src .. "}\n" ..
+      "\\end{figure}"
+    )
+  end
+end

obsidian_export-0.1.0/obsidian_export/assets/filters/escape_strings.lua

@@ -0,0 +1,30 @@
+-- escape_strings.lua
+-- Escape LaTeX-special characters (^ and ~) in plain text Str nodes.
+-- When ^ or ~ are found, converts the entire Str to a RawInline(latex) with
+-- all LaTeX specials properly escaped (including $, &, %, #, _, {, }, \).
+-- Only applies when outputting LaTeX (PDF). DOCX and other formats: no-op.
+if FORMAT ~= "latex" then return {} end
+
+local function escape_latex_specials(s)
+  -- Order matters: escape backslash first to avoid double-escaping
+  s = s:gsub("\\", "\\textbackslash{}")
+  s = s:gsub("%%", "\\%%")
+  s = s:gsub("%$", "\\$")
+  s = s:gsub("&", "\\&")
+  s = s:gsub("#", "\\#")
+  s = s:gsub("_", "\\_")
+  s = s:gsub("{", "\\{")
+  s = s:gsub("}", "\\}")
+  s = s:gsub("%^", "\\^{}")
+  s = s:gsub("~", "\\textasciitilde{}")
+  return s
+end
+
+function Str(el)
+  local orig = el.text
+  -- Only intercept when ^ or ~ are present; otherwise let pandoc handle normally
+  if not (orig:find("%^") or orig:find("~")) then
+    return el
+  end
+  return pandoc.RawInline("latex", escape_latex_specials(orig))
+end

obsidian_export-0.1.0/obsidian_export/assets/filters/fix_tables.lua

@@ -0,0 +1,104 @@
+-- fix_tables.lua
+-- Replace Table AST nodes with xltabular RawBlock for PDF output.
+-- Uses equal-width X columns (from tabularx) with page-breaking (from longtable).
+-- Header rows repeat on continuation pages via \endhead.
+if FORMAT ~= "latex" then return {} end
+
+local meta_table_fontsize = nil
+
+function Meta(meta)
+  if meta.table_fontsize then
+    meta_table_fontsize = pandoc.utils.stringify(meta.table_fontsize)
+  end
+end
+
+local function cell_to_latex(blocks)
+  if #blocks == 0 then return "" end
+  local doc = pandoc.Pandoc(blocks)
+  local result = pandoc.write(doc, "latex")
+  -- Strip document boilerplate, keep body content only
+  result = result:match("\\begin{document}%s*(.-)%s*\\end{document}") or result
+  -- Assign to local to discard gsub's second return value (substitution count)
+  local trimmed = result:gsub("^%s+", ""):gsub("%s+$", "")
+  return trimmed
+end
+
+local function col_spec(align)
+  if align == pandoc.AlignRight then
+    return ">{\\raggedleft\\arraybackslash}X"
+  elseif align == pandoc.AlignCenter then
+    return ">{\\centering\\arraybackslash}X"
+  else
+    return ">{\\raggedright\\arraybackslash}X"
+  end
+end
+
+function Table(el)
+  local n = #el.colspecs
+  if n == 0 then return el end
+
+  local col_specs = {}
+  for i = 1, n do
+    col_specs[i] = col_spec(el.colspecs[i][1])
+  end
+
+  local fontsize_cmd = "\\" .. (meta_table_fontsize or "small")
+  local lines = {}
+  table.insert(lines, "{" .. fontsize_cmd)
+  table.insert(lines, "\\begin{xltabular}{\\linewidth}{" .. table.concat(col_specs) .. "}")
+
+  -- Header rows (bold) with longtable continuation headers
+  if el.head and el.head.rows and #el.head.rows > 0 then
+    -- First page header: toprule + header + midrule
+    table.insert(lines, "\\toprule")
+    local header_lines = {}
+    for _, row in ipairs(el.head.rows) do
+      local cells = {}
+      for _, cell in ipairs(row.cells) do
+        -- pandoc 3.x uses cell.content (not cell.contents)
+        local content = cell_to_latex(cell.content or cell.contents or {})
+        if content ~= "" then
+          table.insert(cells, "\\textbf{" .. content .. "}")
+        else
+          table.insert(cells, "")
+        end
+      end
+      table.insert(header_lines, table.concat(cells, " & ") .. " \\\\")
+    end
+    for _, hl in ipairs(header_lines) do
+      table.insert(lines, hl)
+    end
+    table.insert(lines, "\\midrule")
+    table.insert(lines, "\\endfirsthead")
+
+    -- Continuation page header: midrule + header + midrule
+    table.insert(lines, "\\midrule")
+    for _, hl in ipairs(header_lines) do
+      table.insert(lines, hl)
+    end
+    table.insert(lines, "\\midrule")
+    table.insert(lines, "\\endhead")
+  else
+    table.insert(lines, "\\toprule")
+  end
+
+  -- Body rows
+  for _, body in ipairs(el.bodies) do
+    for _, row in ipairs(body.body) do
+      local cells = {}
+      for _, cell in ipairs(row.cells) do
+        local content = cell_to_latex(cell.content or cell.contents or {})
+        table.insert(cells, content)
+      end
+      table.insert(lines, table.concat(cells, " & ") .. " \\\\")
+    end
+  end
+
+  table.insert(lines, "\\bottomrule")
+  table.insert(lines, "\\end{xltabular}")
+  table.insert(lines, "}")
+
+  return pandoc.RawBlock("latex", table.concat(lines, "\n"))
+end
+
+return {{Meta = Meta}, {Table = Table}}

obsidian_export-0.1.0/obsidian_export/assets/filters/newpage_on_rule.lua

@@ -0,0 +1,9 @@
+-- newpage_on_rule.lua
+-- Convert HorizontalRule to \newpage in LaTeX/PDF output.
+-- In Obsidian notes, --- is commonly used as a section divider
+-- where a page break is the intended PDF behaviour.
+if FORMAT ~= "latex" then return {} end
+
+function HorizontalRule()
+  return pandoc.RawBlock("latex", "\\newpage")
+end