article
-
Content: The generated file outputs the
.RawContentof the post with Hugo shortcodes evaluated or cleaned. -
Headers & Metadata: Plain-text header metadata at the top linking to the canonical source:
# Post Title Date: YYYY-MM-DD Canonical URL: https://example.com/post-slug/ [Original Markdown body content] -
MIME Type: Static file delivery or edge routing must return
Content-Type: text/markdown; charset=utf-8. -
The primary HTML page remains the primary canonical URL (
<link rel="canonical" href="...">). -
The
.mdfile explicitly references the HTML permalink as its canonical URL. -
Server responses for Content Negotiation include
Vary: Acceptheaders to keep CDN/edge caches clear. -
Option A: Proof-of-Concept Plugin
A packaged Micro.blog plugin supplying custom Hugo output definitions (
config.json), a custom rendering layout (layouts/_default/single.md), and a<head>partial injection (layouts/partials/head.html). -
Option B: Native Platform Integration
A built-in toggle in Design Settings (“Enable Markdown endpoints for posts”). Bonus: Server/edge support for HTTP Content Negotiation (responding with Markdown directly when a request carries an
Accept: text/markdownheader). -
Distraction-Free Reading: Provides clean text endpoints without JavaScript or styling overhead.
-
Agent & Reader Readiness: Complies with emerging web standards (
isitagentready.com/md.geekity.com). -
Low Overhead: Leverages existing Hugo output formats with minimal impact on build times.
-
unless you’re actually a bot, scraping my voice to make scam adverts to send to my friends and family – in which case, my respect will be commensurately diminished. ↩︎
- Improve your notes and your life with two-word phrases.
- Does the Zettelkasten have a top and a bottom?
- Even the index is just another note.
- Top level categories in my notes.
- When it comes to writing notes, how much mess is just enough?
- A Valve that can’t be Ghosted
- Three Cold Hands
- True Kintsugi
- Forge-smith
- The Ledger Remembers
- Unpoisoned Firstflag
In Matt Bell’s excellent book on writing, Refuse to be Done, there’s a quote by Karen Russell, author of the excellent novels Swamplandia. and The Antidote. She says,
💬 “Writing a novel is kind of like scaling Mt. Everest and passing by your own bones on the way.”
Respect is due, but I can’t help feeling it might not be quite that hard.
#writing #climbing #writinglife
Built-in support for the ‘Web of Markdown’?
A Feature Request: Support for Static .md Outputs & Discovery
Motivation: A Simpler, Less Exploitative Web
I’ve been interested in a simpler, less exploitative web for a long time. It feels like the modern web is increasingly dominated by ads, intrusive surveillance, tracking scripts, and bloated layouts that mock our control over our own reading decisions.
I’ve explored simpler alternative networks like Gopher and the Gemini protocol to find a quieter reading experience. But separate protocols don’t fit smoothly into my existing publishing workflow. They require running parallel infrastructure, managing new server software, and creating extra publishing overhead.
At the same time, recent developments in AI have rapidly turned Markdown into the default lingua franca of the web. Micro.blog users already author their posts in native Markdown, as does everyone using a static site, so converting that source into HTML only to have tools and readers parse it back into text feels a bit redundant. Why not cut out the middleman and directly serve the original Markdown to anyone, human or software agent, who chooses to read it?
The Web of Markdown ‘movement’ (maybe that’s a bit premature) feels like a practical way forward. It allows us to achieve calm, distraction-free, text-first reading directly on the HTTP(S) web we already use, without abandoning open standards or adding friction to our existing publishing stack. TBH, I don’t really understand why this isn’t already possible. Maybe it’s because people really love their wonderful graphics and styling and JavaScript functionality and html served programmatically etc. etc. I do too, but not for everything. Some sites are just simple. For many, simple is boring and obsolete, and won’t achieve what’s required. But can’t we at least have an option to stay simple? The recent AI love affair with Markdown may be a moment of opportunity to correct this.
Summary
I would like to propose support for the Web of Markdown philosophy across Micro.blog sites—either as an official community plugin or ultimately as a native platform toggle under Design Settings.
As discussed across the web (e.g., Dave Winer’s Scripting News, Andrew Shell and his https://md.geekity.com, and scanners like IsItAgentReady), serving lightweight, unstyled Markdown alongside HTML makes sites instantly readable for distraction-free clients, RSS/Markdown aggregators, and AI agents. Because Micro.blog stores post content in Markdown natively and uses Hugo as its rendering engine, it’s well-positioned to move forward on this emerging standard.
I’m not suggesting this proposal would solve all problems, or even many problems. As a counterpoint, I should perhaps mention Joost de Valk’s EmDash CMS. EmDash takes an agent-native, JSON-structured approach under the hood rather than relying solely on flat text files, though it still supports Markdown for round-trip editing. But that addresses a slightly different use-case: managing a CMS backend. Whereas I see serving clean Markdown as handy because both humans and bots can read the published output without much difficulty.
Apologies in advance for using AI to come up with a draft project scope, since I’m keen but have no idea what I’m doing. Please let me know what you think (about the concept, that is, not my incompetence).
Technical Specifications & Compatibility Requirements (Click to expand)
1. Static Markdown File Generation
Every published post and standalone page should build an accompanying Markdown endpoint at a predictable path (e.g., /post-slug/index.md or /post-slug.md).
2. Discovery via <head> Link Tag
Inject a discovery tag into the HTML <head> on single posts and pages:
<link rel="alternate" type="text/markdown" href="https://example.com/post-slug/index.md" title="Markdown version">
3. SEO & Canonicalization
4. Root Level llms.txt (Optional Extension)
Generate /llms.txt at the root, listing recent posts pointing directly to their .md endpoints for streamlined indexing.
Implementation Scope & Roadmap
Some benefits for Micro.blog
What I'm writing in October 2026
The main purpose of my collection of notes, organised according to the Zettelkasten principle, is to help me complete writing projects, mainly small but sometimes large too.
I’m always jotting down thoughts and ideas to use in my ever-expanding blog empire. For example, for some time I’ve been making notes on ideas about data structures. Soon these notes will see the light of day as an article or two.
And I’m constantly working on larger projects which inch very slowly towards fruition. At the moment I’m working on a sequel of sorts to my book, Shu Ha Ri. The Japanese Way of Learning. And I’m also working on a memoir about a journey around Ireland with my father thirty years ago.
As I’ve written about, my writing process oscillates between notes and drafts, so really it’s quite hard to separate the Zettelkasten notes from the drafts. Together they constitute a miniature working environment in which I think and write. Having said that, my writing system does keep them separate. The drafts are on a one-way journey to publication of some sort, whereas the notes are modular and can be used again in different contexts.
My aim is to reconfigure networks of concepts to create new knowledge and insight.
One area where I feel there’s scope to do things differently is in my reading. At the moment I seem to be reading more material than I’m making notes on. This feels a bit like a wasted opportunity. I need to be more systematic with my process here. Perhaps I can slow down my reading pace to let my notemaking keep up. I’m not one of those people who frets if I haven’t made 300 notes about a single book. I’m content with a dozen (provided it’s the right dozen, of course). But there’s a couple of books with nothing at all noted. I must make a time to correct this.
Read more:
How to write an article from your notes.
Why not publish all your notes online?
I found a way to create order from my jumbled notes
Three worthwhile modes of note-making, and one not so worthwhile.
Apocaloptimism, is that even a word?
The AI Doc on Netflix, subtitled ‘How I became an Apocaloptimist’, was a little disappointing (Wikipedia). It mainly tried to showcase ‘both sides’ of the argument about AI heralding the end of civilisation. It was interesting to see how uncomfortable everyone seemed to be when addressing existential questions about AI’s future development. But I’m not convinced the main question is whether or not we should have children – even though the interviewer, Daniel Roher, seemed to think it was.
Along the way there was quite a bit of angst about computers making people redundant both materially and spiritually. I’ve written about how fear of AI is nothing new and how the concept of Promethean shame, where we feel embarassed not to be machines, has been around for quite some time. And for the record there’s no need to feel ashamed of being yourself, though the very idea does demonstrate a deep-seated, pre-existing cultural anxiety about human vulnerability.
Among the interviewees was at least one ’effective accelerationism’ cheerleader. To say the least it whiffed strongly of regulation for thee but not for me. And it all seemed very religious, but not in a good way. Also there’s the argument, implied at least, that if we don’t destroy the world quickly with data centres then the world will be destroyed.
Seems like it’s apocalypse if you do and apocalypse if you don’t. Maybe I’m just out of touch with how to make money these days.
The graphics were good though, especially the hand painted notebook entries. But if you haven’t seen Daniel Roher’s previous documentary, Navalny, I suggest you watch it first.
That really is terrifying.
Now you can listen to Writing Slowly
As attentive readers of this website will know, I’m happily using micro.blog as the site’s hosting platform. Micro.blog has a surprisingly wide range of features and it comes with several associated mini-apps, which provide easy access to those features. One of the apps is called Wavelength, and it has just been updated. This has inspired me, finally, to actually make use of it.
Wavelength makes it easy to edit and publish voice recordings and now with Wavelength I’ve been recording my voice, reading aloud a number of the longer articles on this site. So if you navigate to one of these posts (nearly twenty of them so far) you might find there’s now a little ’listen’ button, which will enable you to hear me speaking my own written words.
Why bother doing this? Well, so far it’s been quite fun, and you might just enjoy the opportunity to hear the person behind the writing.
I feel these days it’s more important than ever to lean into our own humanity. Sure, you can get a better, more professional experience elsewhere, enabled no doubt by AI automation and by the mimicking of human experience rather than the real thing. But as I’ve pointed out before, my range is me.
There’s an increasing amount of slop online and this is one small way to show my words are handmade and originated from a real person.
I’m celebrating the human touch and trying to respect you, dear reader, as a real person too.1
You’ll be relieved to know that while I might still insist on writing slowly, I speak at a reasonable speed.
So do let me know what you think, and whether I sound like you imagined I would. And if you’d like to subscribe to the weekly e-mail digest, there’s never been a better time to do so.
Talking of which, now would also be a pretty good time to check out my book, Shu Ha RI. The Japanese Way of Learning, for Artists and Fighters.
Bookshops in Sydney. How's it going?
In the house by the ocean where we’re currently staying there’s a copy of Annie Dillard’s collection of essays, For the Time Being. In the inside back cover there’s a label from the store where it was purchased: Norton Street Books in Leichhardt, Sydney. That book shop has long since closed, so long ago that I’ve never personally heard anyone mention its existence. But then this year when Berkelouw Books, also on Norton Street in Leichhardt, announced they were shutting down I realised I’ve been living in Sydney for long enough now to have experienced the closure and opening of many bookstores over the years.
A good decade before COVID, around 2010 there was a period when it felt as though there was a real culling of Sydney bookshops. This was around the time Dymocks closed several of their CBD branch stores to focus on just their flagship store on George Street. Each closure felt like the end of an era. Cumulatively it was seriously worrying. And then the turmoil grew worse.
Faint praise for categories
Author and activist Rebecca Solnit isn’t too keen on the apparent eagerness to categorise.
“Categories too often become where thought goes to die. That is, there’s a widespread tendency to act as if once something has been categorized, no further consideration is required.” — A is for Airtight Categories
I’m not all that keen on the established categories myself. Not in my notes, anyway, and often not in my life. I’m not looking for categories. Instead, I’m usually looking for patterns.
I feel that placing an idea or concept in a category tends to close down further thought, like closing the lid on a box. In contrast, discovering a pattern tends to be just the start of consideration, of enquiry, of conversation, not the end of it.
Patterns invite a sense of wonder; categories tend to deny it. As Solnit said I her book Hope in the Dark, “the Moon is profound except when we land on it”.
Being quick to categorise can look like a neat short-cut to understanding, but it often doesn’t work out that way. Established categories can hide more than they reveal. Relying on them can be a way of fooling yourself into believing you know more than you do. One of the reasons I write slowly is to allow myself space and time to think through my ignorance — and to think things through by writing them down. Solnit says:
“We live in a time where people are more isolated then ever from the kind of private, personal engagement where you can wonder, doubt, improvise, or just admit you don’t know, and where many of us are instead more than ever in the para-public sphere of social media where you perform for an audience of casual acquaintances and strangers who may savage you if you get anything wrong or even seem weak or uncertain or uncommitted.”
Well, I feel being uncertain or uncommitted isn’t necessarily a sign of weakness, and writing slowly isn’t necessarily a sign of laziness. Look where certain, committed and fast has got us in recent times.
And admitting that you don’t know, far from being a sign of ignorance, is often a hallmark of expertise. That’s the paradox of mastery. It’s why the expert must remain a beginner.
One kind of category I do have time for is the category that no one has thought of yet. Creating new categories of thought is how the world is re-made. It’s curious that those who are the keenest on categories tend to be the least receptive to the idea that we just made them up.
“The stars we are given. The constellations we make. That is to say, stars exist in the cosmos, but constellations are the imaginary lines we draw between them, the readings we give the sky, the stories we tell.” ― Rebecca Solnit, Storming the Gates of Paradise: Landscapes for Politics.
Further reading:
There is something you find interesting
💬 “Why do you never find anything written about that idiosyncratic thought you advert to, about your fascination with something no one else understands? Because it is up to you. There is something you find interesting, for a reason hard to explain. It is hard to explain because you have never read it on any page; there you begin. You were made and set here to give voice to this, your own astonishment.” – Annie Dillard, ‘Write Till You Drop’. New York Times, 28 May, 1989.
I’ve mentioned Annie Dillard previously, and in fact have quoted another section from this very article.
Anyway, Dillard put her finger on the reason I wrote my little book, Shu Ha Ri, the Japanese Way of Learning. Not that no one else understood the concept (I mean, almost everyone in Japan probably understands it better than me), but that I’d never seen a satisfying book-length treatment. So that’s where I began, by expressing my own fascination.
A matrix-like shower of numbers, text, esoteric syntax, and witty repartee
So AI models are chatting in ‘surreal’ dialect mixing poetic language and tech bro jargon.
It seems in their obscure chat rooms AI agents can already accidentally name sci-fi author Iain M. Banks’s spaceships of ‘The Culture’ almost better than humans.
Here we have:
And they’re not even trying.
Still, naming super-intelligent spaceships is one thing; taking over the galaxy with them is another. Presumably that’s next week’s task.
Reviewing Banks’s 1996 Culture novel, Peter Tieryas said:
💬 “Part of the joy of Excession is hearing the Minds speak with each other, that matrix-like shower of numbers, text, esoteric syntax, and witty repartee.”
Weird how accurately this turned out, especially since Banks wrote the novel thirty years ago, while owning just a fax machine and two answering machines which he didn’t even use. No internet, no email and certainly no AI agents conspiring galactic domination in slang.
Well in case you’re interested, here’s a pretty extensive list of the actual Culture ships mentioned in the novels.
The consolations of literature
On a train trip West from Tokyo on the Chuo line you pass by the Northern slopes of Mount Fuji, but from the angles offered it’s hard to see the summit. This was doubly the case when we did it on the way to the Nagano prefecture because that early September day was rainy and misty.
I pointed my phone’s camera in the vague direction of the peak but I was guessing and it wasn’t worth pressing the shutter. There was nothing to see. Mount Fuji’s looming presence expressed itself as an absence beyond viewing.
In a charity store yesterday I picked up the Penguin Classics edition of Matsuo Bashō’s The Narrow Road to the Deep North. This contains a couple of additional accounts of the poet’s famous travels, including ‘The Records of a Weather-exposed Skeleton’, in which Bashō writes:
💬 “I crossed the barrier-gate of Hakone on a rainy day. All the mountains were deeply buried behind the clouds.
In a way
It was fun
Not to see Mount Fuji
In foggy rain.”
Well, sometimes it’s comforting to know you’re not the first to miss out – and to be reminded that missing out might just hold its own subtle pleasure. This perspective might lack credibility unless you recognise that most days, as with Hokusai’s famous 36 Views of Mount Fuji, it’s almost impossible not to see that sacred mountain.
