Guide: Publishing to Hugo/Jekyll Remotely via IOS


Comments: 0

Hugo excels at desktop publishing. I can create files using CLIs or markdown editors, then publish to a Github repository. This directly reflects on the website through Netlify, Cloudflare Pages or Vercel.

However, publishing from my phone is not as straightforward. I have a micropost section on my website, intended to be a Twitter replacement, where I share posts that are:

  • Short
  • Contain photos taken from my phone
  • Can be published quickly

I initially thought that the only feasible way to publish using my phone was via Micropub. This is evident in direct integrations with writing apps such as UlyssesiA Writer and Paper.

The issues with Micropub are:

  • It’s extremely difficult to set up for someone without a technical background, like myself.
  • The only feasible way I’ve managed to get this to work is via Voxpelli’s Solution.
  • Even then, it costs money to host a micropub solution. The only free way I’ve managed to get this to work is via Render, which only spins up the server when in use.
  • This is problematic for my use case, because it takes a long time to publish a micropost, it often displays an error and there’s a high risk of double-posting.

A Much More Elegant Solution

Because micropub wasn’t working, I stumbled upon a different approach — creating and editing markdown files directly within the GitHub repo itself.

Unfortunately, GitHub’s native app doesn’t provide an efficient way to create and edit markdown files. That’s when I discovered Working Copy — an iOS Git client that GitHub should have been.

What’s more interesting is Working Copy’s integration with Shortcut Actions, which allows me to publish microposts via the action button on my iPhone. Hence, you can easily repurpose the shortcut to create your own customised templates or run via widgets or phone back taps.

Link to my shortcut:

Shortcut in Action

I have two types of microposts — with photo and without. My shortcut differentiates the two based on whether the image is within my clipboard:

Without Photo:

With Photo:


  • You’re able to change the note’s file destination and template by adjusting parameters within the shortcut.
  • This method only works on JPEG images.
  • This method assumes that you’ll be posting photos via YAML, rather than in-line. This requires adjustments to be made to layout HTML files with the following code, depending on where you need the image displayed.
 {{ if}}
 <img loading=“lazy” src=“{{ }}” alt=“Photo” style=“max-width:200px; height:auto;”>
 {{ end }}

Hopefully, this quick tutorial is helpful to you! Let me know if you have any questions below.

Share via:

Leave the first comment