Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Action] Export as GitHub-Markdown (gfm) #160

Open
cagix opened this issue Aug 31, 2023 · 0 comments · May be fixed by #161
Open

[Action] Export as GitHub-Markdown (gfm) #160

cagix opened this issue Aug 31, 2023 · 0 comments · May be fixed by #161
Assignees

Comments

@cagix
Copy link
Owner

cagix commented Aug 31, 2023

Add an additional build target to make the content available as GitHub markdown (gfm).

GH-Markdown has additional new syntax for math: https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions ... this should resolve some cases where "traditional" math (using $ or $$) is not being recognised properly. Define a custom Lua filter, but maybe Pandoc does support this out of the box now (e.g. jgm/pandoc#9156).

support for boxes could be done via "gh markdown alerts" (https://github.com/orgs/community/discussions/16925).

replace \operatorname{x} w/ \mathop{\text{x}} (see github/markup#1688)


Release als GitHub-Markdown (als Branch einchecken, von Readme aus verlinken) analog zu _slides und _hugo

GH-Markdown kann mittlerweile sogar MathJax, d.h. man müsste die Toolchain so anpassen, dass Abbildungen skaliert werden und Referenzen aufgelöst werden. Ggf. braucht man hier noch ein eigenes Markdown-Template, um die einzelnen Bausteine in der richtigen Reihenfolge zu haben.

Damit könnte man sich das Skript in "nüchtern" direkt im GH ansehen.

@cagix cagix self-assigned this Aug 31, 2023
@cagix cagix linked a pull request Aug 31, 2023 that will close this issue
7 tasks
@cagix cagix changed the title [Action] Add export of GitHub-Markdown (gfm) [Action] Export as GitHub-Markdown (gfm) Sep 1, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: No status
Development

Successfully merging a pull request may close this issue.

1 participant