💾 Archived View for gemi.dev › gemini-mailing-list › 000093.gmi captured on 2023-12-28 at 15:41:10. Gemini links have been rewritten to link to archived content

View Raw

More Information

⬅️ Previous capture (2023-11-04)

🚧 View Differences

-=-=-=-=-=-=-

[ANN] md2gemini - a markdown to gemini converter

1. colecmac (a) protonmail.com (colecmac (a) protonmail.com)

Evening Geminauts!

I've created another Gemini tool, they're lots of fun.
This one takes Markdown files and converts them into the Gemini
text format. I've heard some people mention something like this
on the mailing list before, and I wanted to make it, so hear you
go! Hope it can be used well.

My ideal usage was to allow for easy bi-hosting of blogs. Often
blogs are written in Markdown, and then transformed with tools
like Jekyll. md2gemini could transform those markdown files into
files ready to host on Gemini. It could even be part of a CGI script,
to convert files on the fly.

In my opinion, its "killer feature" is that it supports markdown tables,
converting them into Unicode or ASCII tables instead. It can also strip
Jekyll front matter [0] from files, which I hope will make bi-hosting with
Jekyll easier.

[0] https://jekyllrb.com/docs/front-matter/

Obviously markdown and gemini are not directly compatible. When things
in markdown don't apply to gemini, I just left them in plain text.
This applies to indented lists, block quotes, inline code, etc.
There was discussion earlier about footnote links, which is something I plan
to support, but for now this code just takes inline links and converts them
into gemini links, splitting up the paragraph.

It's available at https://github.com/makeworld-the-better-one/md2gemini
Let me know what you think!

makeworld

Link to individual message.

2. Ben (benulo (a) systemli.org)

Hey, I installed this using `pip3 install --user md2gemini` and the 
installation appears to have succeeded, but at the moment there doesn't 
seem to be an md2gemini executable or script that I could run from the 
command line.

Link to individual message.

3. colecmac (a) protonmail.com (colecmac (a) protonmail.com)

Glad to hear you tried it!

So I looked into some things, and it looks like I made a mistake
with the package. Sorry about that, it's my first time putting one
on PyPI. For now, you should be able to run it with:

python3 -m md2gemini <options here>

I will find out how to have an executable and update the package.
I might not announce the update here, but feel free to watch the project
on Github, and/or update using pip.

Thanks for catching this!

makeworld

??????? Original Message ???????
On Saturday, May 16, 2020 9:24 PM, Ben <benulo at systemli.org> wrote:

> Hey, I installed this using `pip3 install --user md2gemini` and the
> installation appears to have succeeded, but at the moment there doesn't
> seem to be an md2gemini executable or script that I could run from the
> command line.

Link to individual message.

4. colecmac (a) protonmail.com (colecmac (a) protonmail.com)

Okay, I just fixed it, it should work now. Thanks for catching
that! Just update it through pip.

If you or anyone else finds anymore issues, or has feature requests,
feel free to email me or make an issue on Github!

makeworld

??????? Original Message ???????
On Saturday, May 16, 2020 9:24 PM, Ben <benulo at systemli.org> wrote:

> Hey, I installed this using `pip3 install --user md2gemini` and the
> installation appears to have succeeded, but at the moment there doesn't
> seem to be an md2gemini executable or script that I could run from the
> command line.

Link to individual message.

5. solderpunk (solderpunk (a) SDF.ORG)

Nice work, thanks for a useful little tool!  It's on the software list
now.

Cheers,
Solderpunk

Link to individual message.

---

Previous Thread: Announcing jan.bio & ncgopher gemini support

Next Thread: [ANN] Gemini Mailing List gemini mirror