This is the official manual for the latest Org-mode release.
Extracting source code from code blocks is a basic task in literate programming. Org has features to make this easy. In literate programming parlance, documents on creation are woven with code and documentation, and on export, the code is tangled for execution by a computer. Org facilitates weaving and tangling with several customization options for producing, maintaining, sharing, and exporting literate programming documents.
When Org tangles the source code blocks, it expands, merges, and transforms them. Then Org recomposes them into one or more separate files (as specified in the options). During this tangling process, Org expands variables in the source code, and resolves any “noweb” style references (see Noweb reference syntax).
With prefix argument only tangle the current code block.
org-babel-tangle, making it suitable for post-processing, compilation, and evaluation of code in the tangled files.
Debuggers normally link errors and messages back to the source code. But for
tangled files, we want to link back to the Org file, not to the tangled
source file. To make this extra jump, Org uses
org-babel-tangle-jump-to-org function with two additional source code
block header arguments: One, set
padline (see padline) to true
(the default setting). Two, set
comments (see comments) to
link to tell Org to insert links to the Org file.