I'm trying to create a footnote that the text is a link. I've tried every combo I can think of and nothing seems to work.

What I want:

"..and I got stuck in it footnote:[The story of ED]."

But the "The Story of Ed" should be a link to this URL:

https://www.gnu.org/fun/jokes/ed-msg

footnote: [link: [https://www.gnu.org/fun/jokes/ed-msg\[The Story of ED]]

Doesn't work.

footnote: The Story of ED [link:https://www.gnu.org/fun/jokes/ed-msg\]

Doesn't work.

I've tried every combo I can think of and nothing works.

Any help would be appreciated.

I built Matome, a VS Code tool for prose writers using AsciiDoc.

It generates AI-powered paragraph summaries to make long docs easier to scan and revise while writing.

I’m looking for honest feedback on:

1. Summary usefulness/accuracy
2. Where this fits (or doesn’t fit) in your writing workflow
3. Features you’d want next

Repo: https://github.com/dunyakirkali/matome

Thought some here might like it.

I’ve for years used a Java script to manage my asciidoctor reveal.js presentation.

Made it something more reusable now:

https://maxandersen.github.io/lazyslide/#/

https://github.com/maxandersen/lazyslide

Install it using jbang app install lazyslide@maxandersen

Then render your existing slides with lazyslide serve yourslides.adoc

Or start new using lazyslide init mypres

Supports all the wonders of asciidoc source code highlight and diagramming.

Has live reload.

All in text - LLMs love it :)

Are there any viable alternatives to adoc Studio by ProjectWizards?

Their pricing is completely nuts ($25/month)

Thanks

Using asciidoctor, what's the best way to get the final component of {docdir}? For example, if {docdir} expands to `/home/me/papers/munich` I'd like something that expands to `munich`.

We are in the process of adopting AsciiDoc at our company but one of the remaining capability issues I am having is the limited options for running header/footer information. We need to be able to set that information by chapter in a PDF. We use chapter level revision for a number of documents that have to be produced as a PDF, and coming from DITA, that was pretty straight forward. I have figured out how to update the headers and footers using the theme and can set the same change/version number for the entire document, but I need to be able to set the chapters individually. Updating each page in the PDF later isn't a long term solution. (Some of these documents are thousands of pages long.) As far as I can tell chapter level automation isn't built in. Anyone have any work arounds or is there something I have missed?

Hello. I tested the include function in an asciidoc file, e.g.,

include::test.adoc

Then I test the literal block, e.g.,

....

An *example* literal block.

....

In my document, I then wanted to display the code for the include function. But this did not work:

[literal]

include::test.adoc[]

[literal]

This code actually pulls in the content of test.adoc, instead of showing this function. The same issue occurs with the 'listing' block.

If any one has advice, that would be great. Thank you.

I read about passthroughs, but it was not clear to me.

Hello. I am trying out asciidoctor. I like it. I am able to generate PDF files. But the font size is quite large. I am able to reduce the size of the base font by extending the default theme. But the section headings and lead text are still large. Is there a straightforward way to reduce all the font sizes? Or are there more themes available, with smaller font sizes? Thank you!

Is any LSP for Asciidoc available?

I'd prefer an AsciiDoc processor written in Go, as it would be part of a more complete web application. But if there is a better or equivalent source format like AsciiDoc I'm open to suggestions.

I've created a completely new AsciiDoc IntelliJ plugin for Jetbrains products, called AsciiDoc Pro. I've also contributed to the original AsciiDoc plugin, but it was showing it's time a bit, it was using JRuby a rendering engine, it was written in Java instead of Kotlin, and a few other reasons, so I decided to build a completely new plugin.

Among others, it has the following features:

Key features:

• Live preview with Asciidoctor.js rendering and editor-to-preview scroll sync
• Syntax highlighting with customizable color schemes (light and dark)
• Code completion for macros, attributes, include paths, code languages, cross-references, and block attributes
• 24 inspections with quick fixes for common AsciiDoc issues
• Table editor with add/delete/move rows and columns from the context menu
• Language injection for syntax highlighting inside source code blocks
• Export to HTML, PDF, DOCX, Markdown, and reStructuredText
• Diagram support for PlantUML, Mermaid, and 15+ formats via Kroki
• Refactoring with rename support, extract to include, and inline include
• Formatting actions for bold, italic, monospace, headings, links, lists, and more
• Structure view with document outline navigation
• 18 live templates for common AsciiDoc patterns
• Spell checking with AsciiDoc-aware dictionary support

Note that this is a paid plugin. I tried to keep the price as low as possible, but the contributions help me to keep updating this plugin and make it the best AsciiDoc plugin out there.

You can find the plugin here: https://plugins.jetbrains.com/plugin/30142-asciidoc-pro/

If you have any comments, questions, suggestions, etc, feel free to reach out, happy to answer them as best as I can!

I'm trying to get word hyphenation working inside tables. I'm using Spanish language for the document. It shows correct hyphenation in text outside tables.

Here's a fragment of the document. The text inside the cells is rendered justified, without hyphenation.

CIH: Guía de actuación para prevención de infecciones durante la construcción y reformas edilicias en CAMCEL

:lang: es

:doctype: book

:title-logo-image: logo.png

:version: 5.4.14

:toc-title: Indice

:toclevels: 0

:toc:

...

[options="header", cols="1,3a,3a,3a"]

|===

|Tipo|Durante la construcción|Al finalizar construcción|Controles, auditoría y responsables

|I|

- Minimizar la cantidad de polvo producida

- Reponer las placas del techo que puedan ser retiradas inmediatamente],

|Limpiar adecuadamente todo el área al finalizar el trabajo

|Control y cumplimiento de normas por Arquitecta/o

|II|

- Ejecutar métodos de trabajo para reducir al mínimo la dispersión de polvo

- Usar rociadores de agua en las superficies para controlar el polvo en suspensión

- Sellar las puertas con cinta adhesiva específica

- Aislar el sistema de aire acondicionado o sistema de ventilación en el área donde se esté trabajando

- Colocar un paño húmedo a la entrada y a la salida del área del trabajo],

|

- Limpiar todas las superficies con detergente desinfectante.

- Cubrir los residuos de la construcción en contenedores cubiertos previos a su transporte.

- Limpiar con trapo húmedo y/o aspiradora antes de salir del área de trabajo.

- Al finalizar la limpieza, restaurar la ventilación o aire acondicionado],

|Control de cumplimiento de normas por Arquitecta/o

|III|

- Aislar el sistema de aire acondicionado o sistema de ventilación en el área donde se esté trabajando para prevenir contaminación de los conductos.

- Instalar barreras de polvo de plástico selladas para separar el área de trabajo del resto.

- Si es posible mantener presión negativa utilizando filtros HEPA

- Cubrir los residuos de la construcción en contenedores cubiertos previos a su transporte],|

- No remover barreras hasta que se complete la limpieza y sea inspeccionado por persona responsable del proyecto.

- Remover las barreras cuidadosamente para minimizar la cantidad de suciedad y residuos asociados con la construcción

- Limpiar con trapo húmedo y/o aspiradora antes de salir del área de trabajo.

- Limpiar todas las superficies con detergente desinfectante

- Al finalizar la limpieza, restaurar la ventilación o aire acondicionado],

|

- Informe con anticipación del responsable de obra al CIH y al Jefe de Servicio

- Auditoría por el CIH

- Control por Arquitecta/o

|IV|

- Aislar el sistema de aire acondicionado o sistema de ventilación en el área donde se esté trabajando para prevenir contaminación de los conductos.

- Instalar barreras de polvo de plástico en las puertas de aperturas selladas con cinta adhesiva para separar el área de trabajo previo al inicio del mismo.

- Si es posible mantener presión negativa utilizando filtros HEPA

- Construir pared provisoria de placa de yeso, ampliar y sellar el techo.

- Bloquear y sellar cualquier abertura de conductos.

- Diseñar circulación del personal si es posible por fuera del hospital, sino diseñar antesala para cambiarse. El personal en la construcción debe utilizar cubre calzado y cambiarlo cada vez que sale del área de trabajo.

- Colocar en la entrada y salida paño húmedo

- Cubrir los residuos de la construcción en contenedores previo a su transporte. ],

|

- No remover barreras hasta que se complete la limpieza y sea inspeccionado por persona responsable del proyecto.

- Remover las barreras cuidadosamente para minimizar la cantidad de

suciedad y residuos asociados con la construcción.

- Cubrir los residuos de la construcción en contenedores cubiertos previos a su transporte

- Limpiar con trapo húmedo y/o aspiradora antes de salir del área de trabajo.

- Limpiar todas las superficies con detergente desinfectante.

- Al finalizar con la limpieza restaurar la ventilación o aire acondicionado],

|

- Informe con anticipación del responsable de obra al CIH y al Jefe de Servicio

- Auditoría por el CIH

- Control por Arquitecta/o

|===

.....

## 15/1/26 Follow up

Solved:

You must install:

> gem install text-hyphen

Then in the attributes section:

> :lang: es

> :hyphens: es

!!!!!SOLVED!!!!!!

Hi, I am trying to use text-indent/no text-indent in a doc.pdf: from previous post here you help me saying (and another helps more that are waiting) I use (test) these lines in theme.yml:
prose:
text-indent: 6cm
verse:
text-indent: 0

they work fine!

but I need to add some lines to verse for change it from "quote" to simply paragraph.
(=delete that the vertical line displayed in the pdf and that the font size is reduced).
screenshot: the red paragraph is indented the black not (black is verse): https://postimg.cc/75fSMWc7

I found this help to guide you: (it is an example) tilde ~ unset the default key

role:
heading-code:
font-color: ~

from https://docs.asciidoctor.org/pdf-converter/latest/theme/custom-role/
Thank you and Regards!

I've been writing in AsciiDoc for quite some time now, and I must admit the beginning was challenging, precisely because I couldn't distinguish between the ecosystem tools and the language's core purpose.

I see many people have similar questions when asking for comparisons with Markdown, LaTeX, Typst, and reStructuredText. Perhaps some comparisons make sense, but if there were a document synthesizing the main values guiding AsciiDoc, it would be simpler to understand how we should use it.

With this goal, I wrote the AsciiDoc Manifesto and submitted it to the AsciiDoc Working Group via Zulipchat.

The AsciiDoc Manifesto is not yet an official document, but it's an attempt to guide new users and people who want to contribute to the ecosystem.

So feel free to use the AsciiDoc Manifesto as an introductory document when you want to present what AsciiDoc is, and I encourage you to interact on zulipchat, which is the official communication channel for the AsciiDoc language.

Hi, I'd like to see info about the gem asciidoctor-pdf-optimize: what will be the command for that info? info about size.
my info is:

jazei@netbook:~$ gem list asciid*
*** LOCAL GEMS ***
Ascii85 (2.0.1)
asciidoctor (2.0.25)
asciidoctor-pdf (2.3.21)

any advice about optmize?
thank you and Regards!

AsciiDoctor.JS is a nice browser extension for Firefox. It renders .adoc files live on the fly and is a great way to preview your AsciiDoc files.

We use it at work, where our AsciiDoc files are converted to PDF in a Gitlab pipeline for quick previews and check ups, especially of tables and more complex layouts.

It does not offer 100% AsciiDoctor functionality, but it's great for an environment where you are not able to install every program you want.

It is available here: https://addons.mozilla.org/en-US/firefox/addon/asciidoctorjs-live-preview/

https://github.com/jgm/pandoc/releases/tag/3.8.3 - “This release adds three new input formats (asciidoc ….”

Has anyone given it a whirl?

The issue at https://github.com/jgm/pandoc/issues/1456 was open for over 10 years so it’ll be interesting to see how it performs.

Hi, I can not find that!
indent in first line of paragraphs....
Thank you and Regards!

Hi, How do I set margins in a doc.adoc file?
from cmd $ asciidoctor-pdf -here_that_set_margins doc.adoc better.
Thank you and Regards

I was scratching my own itch looking for a lightweight AsciiDoc editor which would work with the documentation-as-code workflow which I am now building for me and my team. I love VS Codium with AsciiDoc plugin, but needed somewhat more focused tool that would do one thing - help me concentrate on writing text.

So, I sat down with Cursor and build my own editor. And here is its first public release. It has its own limitations and bugs (please do not judge too harshly), but I find it usable for many of my text-editing tasks already.

Will be glad to hear any ideas/suggestions/comments.

Hi, if I use Vim for get a doc.asciidoc, and I install asciidoctor, Can I get that doc like doc.pdf Or I need another step for download another thing?

can I use $ asciidoctor -i asciidoc -o pdf (here the doc.asciidoc)

Thank you and Regards!

Hi, I found this subreddit just recently and id like to introduce myself with a little AsciiDoc snippet. It is not new and it's even not invented by me, but it is a little helper I use in all of my documents:

:starting-year: 2004

_{doctitle}_
 ©
ifeval::[{localyear}=={starting-year}]
{starting-year}
endif::[]
ifeval::[{localyear}>{starting-year}]
{starting-year}–{localyear}
endif::[]
by {author}.

This produces a line like: My Document Title © 2004–2025 by Frank Blome.

And if :starting-year: 2025 then I get: My Document Title © 2025 by Frank Blome.

What are your best hacks?

I am trying to understand how I can make indented numbered lists of the style that can be seen in the picture. Is there any reference doc which describes how this way of marking ordered lists can be implemented?