A reference Notebook for observing Changes in our Markdown Format for all available Content-Types
Philipp Markovics, Andrea Amantini
This notebook is meant for testing our Markdown Format.
Paragraphs and Lists
The paragraph is the simplest Nextjournal node type. Internally, paragraphs use a rich-text editing component for text styles: italic,bold, monospaced text and links. Now with strike-trough text as well.
You can embed inline nodes in paragraphs: mathematical formulas, like inline_formula not implemented, references to a file, like
, andnumbers that can be referenced in code cells, like temperature = 70ºC.
Experimental features: inline reference to a cell file results
and inline data nodes like this blue node.
Lists are restricted to a single level at the moment. Typing * followed by a space into an empty paragraph quickly transforms the paragraph into a list:
A list items
followed by another list item
and todo lists
and a checked one
Section numbering is a key at :article -> :settings, re-importing this markdown should bring back section numbering.
This is to quote Ted Nelson:
blockquote not implemented
and he couldn't just be more right.
Files and Images
Files can be uploaded straight to an article. Here is an example of an uploaded CSV file with global temperature data:
If the uploaded file is an image, including SVGs, it will be rendered inline. If the image size exceeds the article’s default content width, layout controls allow expanding the image width beyond the article boundaries.
Images may be captioned.
Standard Width Image
When adding the first cell for a particular language, a runtime is created along with it and added to the code panel. New cells using the same language are appended to the previously existing runtime.
Runtimes provide an isolated computational resource for code cells to run in. For remote execution, code cells that share a runtime share process state and an ephemeral filesystem in the form of a Docker container. Browser-based runtimes execute in a web worker.
Remote runtimes are templated from an environment: a Docker image providing initial filesystem state, a language runtime, and preinstalled software packages.
Bash cells exhibit special behavior. If another language runtime exists, bash cells will be appended to that runtime. This way, you can perform command line work underneath the language process, such as installing Python packages or downloading data.
Process standard output and standard error arestreamed to the browser, between the source code and the final result. Cell output can be toggled. This Bash cell lists the installed PyPi Python packages.
The file is now downloadable in the browser and can be referenced from other code cells, or even from another article. All results on the filesystem can be referenced using the @ menu in a code cell, followed by Insert Reference: